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FOREWORD 


The Thermal Radiation Analyzer System (TRASYS) program marks the 
first instance that thermal radiation analysis has been put on the same basis 
as thermal analysis using program systems such as MITAS and SIKDA. As %iith 
these thermal analyzer programs , the user is provided the powerful options of 
writing his own executive, or driver logic and choosing, among several 
available options, the most desirable solution technique(s) for the problem at 
hand. In addition, many features never before available in a single radiation 
analysis program are provided. 

Among the more important are: 

e Up to 1000 node problem size capability* with shadowing by 
intervening opaque or semi-transparent surfaces; 

e Choice of diffuse, specular or diffuse/specular radiant 
interchange solutions; 

• Capability for time variant geometry in orbit; 

• Choice of analytically determined or externally supplied shadow 
data for environmental flux calculations; 

• Form factors and environmental fluxes computed using an 
internally-optimized number of surface grid elements, selected 
on the basis of user-supplied accuracy criteria; 

• Choice of an element to element double integration technique 
and a precision Nusselt Sphere technique for computing form 
factors; 

• A general edit capability for updating thermal radiation model 
data stored on tape* 


^Depending on Computer application. 


• A plot package that provides a pictorial representation of the 
user's gec.etry, orbital/orientation paraaeters, and heating 
rate output data as a function of tine. 

a Capability to autoaatically equate Fom Factors for nodes that 
have been duplicated or iaaged to the corresponding original 
node pair, to eliminate costly redundant coaputations. 

TRASYS is indebted to a number of predecessor programs in the 
thermal radiation analysis field. The major contributors were HEATRATE, MTRAP 
version 2.0, and RAOFAC. 

This User's Manual represents a concerted effort to document the 
capabilities of TRASYS and will, hopefully, serve the twofold purpose of 
instructing the user in all applications and serve as a convenient reference 
book that presents the features and capabilities in a concise, easy-to-find 
manner . 

This User's Manual was generated under a series of NASA 
Contracts. The technical monitoring was provided by Mr. Robert A. Vogt of the 
Thermal Technology Branch of the Structures and Mechanics Division, NASA 
Lyndon B. Johnson Space Center. His helpful suggestions during the 
development of TRASYS are gracefully acknowledged TRASYS would not exist 
without the superb design and programming efforts of Messrs. R. E. Paulson and 
R. J. Connor, who were responsible for generating the majority of the TRASYS 
code. Their efforts are gratefully acknowledged. Extensive thanks are also 
due Mr. G. M. Holmstead for his efforts in developing the direct irradiation 
program segment and for the valuable consulting effort he performed during Che 
course of program development. Mr. R. G. Goble is also recognized for his 
praiseworthy efforts in developing the specular-diffuse radiation interchange 
segment, the orbit plotter segment, and for his solutions of many knotty 
problems Chat cropped up during program checkout. 
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1. INTRODUCTION 


1.1 WHAT IS TRASYS? 

The Thexmel Radiecion Analysis Systesi is a digital coaiputer software 
system with generalised capability to solve the radiation related aspects of 
thermal analysis problems. When used in conjunction with a generalised 
thermal analysis program such as the Systems Improved Numerical Differencing 
Analyser (SINDA) program, any thermal problem that can be expressed in terms 
of a lumped parameter R-C thermal network can be solved. The function of 
TRASYS is twofold. It provides: 

a. Internode radiation interchange data; and 

b. Incident and absorbed heat rate data from 
environmental radiant heat sources. 

Data of both types is provided in a format directly usable by the thermal 
analyser programs. 

One of the primary features of TRASYS is that it allons the user to 
write his own executive or driver program which organises and directs the 
program library routines toward solution of each specific problem in the most 
expeditious manner. The user also may write his own output routines, thus the 
system data output can directly interface with any thermal analyser using the 
R-C network concept. 

Other outstanding features of TRASYS include: 

a. A plot segment that provides pictorial plots of the 
problem geometry as well as output data; 

b. Restart capability that prevents loss of output and 
is very convenient to use; 

c. A generalised edit capability for conveniently 
changing data on Che restart tape; 

d. Geometry may vary with time; 

e. Central processor memory required is adjusted 
dynamically according to problem size; 

f. A choice of solution techniques in Che calculation 
of geometric form factors, depending upon whether 
high precision or minimum computer run time is Che 
primary objective. 
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Allovablc problem else is limited by the esiount of 
centrel memory available. At an installation where 65000 decimal 
words of high speed core are available, problems up to 650 nodes 
are allowed. 

A definitive run time formula for TRASYS cannot be 
stated due to the strong dependence on the experience of the 
analyst, the number of shadowing surfaces in a given problem and 
the way the nodes are geometrically arranged relative to each 
other. Numerous shadowing nodes in close proximity to each other 
will add to run time. Also, heat rates for non^ircular orbits 
generally require much more run time than for circular planet 
oriented attitude because form factors to the planet roust be 
computed for each point in orbit. 

Fjr example, form factors for a relatively large 500 
node model may require 2 to 20 hours of SUP time on a Univac 
1110. In general, run time is proportional to the third or 
fourth power of the problem size. Thus, a 100 node problem may 
only require 6 to 11 minutes for form factors. 

The TRASYS system consists of two major components: 

(1) the preprocessor, and (2) the processor library. The 
preprocessor has two major functions. First, it reads and 
converts the user's geometry input data into the form used by the 
processor library routines. Second, it accepts the users driving 
logic written in the TRASYS modified FORTRAN language that 
directs user-provided and/or library routines in the solution of 
the problem. The processor library consists of FORTRAN language 
routines that perform the functions commonly nec>ded by the user. 
The user has, in some cases, a choice of solution techniques to 
perform the same function. 

1.2 SYSTEM STRUCTURE 

In the usual engineering enviromnent, a programmer is 
commissioned to prepare an applications program which is 
subsequently made available to the engineer on a production 
basis. The engineer supplies input data and receives output 
data, as shown in Figure 1-1. 
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DATA IN 


PROGRAM 


DATA OUT 


FIGURE 1.1: BASIC FLOW IN USING AN APPLICATIONS PROGRAM 

Changes to the logic and equations are difficult for the 
program user to implement conveniently since they must be written 
in a computer^oriented language and submittal may be rt.^uired 
through a formal programming organization. When TRASYS is used, 
however, the engineer need only call on the programnmer to supply 
0 Standard deck of computer oriented "control cards" which will 
call the various elements of the system into action in the proper 
sequence. The engineer then formulates his problem in the 
engineering-oriented TRASYS language, assembling both data and 
solution techniques (i.e., logic and equations) into this card 
deck, which then serves as the complete input to the TRASYS 
system. Programmer support has been minimized since the bulk of 
the programming effort is already built into the TRASYS 
preprocessor and processor library. The engineering user need 
only specify the data and the order and type of "program building, 
blocks" which he deems necessary for the solution of his problen , 
as illustrated in Figure 1-2. 



FIGURE 1-2: BASIC FLOW IN USING TRASYS 
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It thould then be evident thet TRASYS is isuch nore then 
an applications program. It has, in fact, all of the functions 
and capai>ilities of a special purpose operating system. Since 
most computers in current use in engineering environments already 
have operating systems built around a FORTRAN compiler, TRASYS is 
designed to augment the existing FORTRAN system. Hence, the 
TRASYS library serves as an extension to the existing FORTRAN 
library, and the TRASYS program serves as a preprocessor to 
(i.e., it proceeds) the existing FORTRAN compiler. This 
augmentation arrangement is illustrated in Figure 1-3. 



FIGURE 1-3: DETAILED INTERNAL FLOW OF TRASYS 
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Vfhen using the full capability of TRASYS, the enginaar 
will ba raquirad to axart a progranming affort of aorta, in a 
language consisting of FORTRAN statenants and problam oriantad 
TRASYS statamants that era FORTRAN ralatad. This, together with 
the wide variety of options and features offered by the systan, 
suggests an appropriate word of caution: TRASYS is a 
comprehensive system which cannot be mastered overnight. The 
prospective user should not assume that a cursory review of the 
Instruction Manual will lead to inoediate success, nor should he 
assume that this manual represents a "cookbook" which will 
eventually yield to a plodding and rigid adherence to each and 
every rule. In presenting instructions on the use of a computer 
program, it is not possible to completely avoid some 
"cookbook-like" sections; however, every effort has been made to 
explain the "why" and "how" behind each rule, option, end 
feature, with the intent of encouraging the reader to think about 
and understand TRASYS in depth. To help the novice user, an 
attempt has been made to default much of the required input to 
noimally used values so that the user need not define them. 
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2. BACKGROUND INFORMATION 

2.1 TYPOGRAPHICAL CONVENTIONS 

2.1.1 Punched Cards 

The reader is (or soon will be) familiar wich the standard 80 column 
punched card. It is the user's primary means of conveying his input data and 
logic to TRASYS. 

The program input format design is predicated on minimum dependence 
upon data/card column relationships. Most card input is covered by one column 
rule: card columns 1 thru 6 inclusive comprise the control field and columns 7 
through 72 comprise the data field. Data in the control field are used by 
read routines to identify the type of data to expect in the cards' data 
field. In thi^ manual, the typographical convention shown in Figure 2-1 will 
be used to indicate the card columns of interest. (Card columns 1,7 and 12 in 
this case). 

CCl CC7 CC7 

2 

FIGURE 2-1: SAMPLE CARD COLUMN DESIGNATIONS 

Throughout the rest of the manual (in contrast to Figure 2-1) punched 
cards will not be identified as figures. Vlhenever material is presented with 
one 07 more indicators with the format CCX directly above, a punched card is 
indicated. The card data will always be presented as Gothic capitals and /or 
numerals. For example, a card format might be shown as follows: 

CCl CC7 

TITLE THIS IS A SAMPLE TITLE CARD 

In general, the character directly below the column number begins the 
relevant data field. 

2.2 FILE AND TAPE CONVENTIONS 

Since TRASYS can be implemented on a variety of computers, it is 
necessary to refer to data storage media by some nomenclature which will be 
independent of the particular system configuration. FORTRAN "logical unit 
numbers" are often used for this purpose, but were rejected for use in this 
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manual because certain installations impose restrictions on the type of 
physical storage device which may be assigned to a given unit. Instead, each 
serial access storage device referenced by TRASYS is given a proper name as 
follows: 

"PURPOSE tape" 

Hence, for example, the Restart Output Tape referred to as the RSO tape, 
containa the results of processing the user's data, and Edit Input Tape CMERG 
contains input for merging, using the edit routine. "Tape" is used as part of 
the name only because a reel of magnetic tape is normally associated with 
computer storage. However, any "Tape" may, in fact, be a disk file, a drum 
file, a punched paper tape, or a magnetic tape, at the option of the user. 
Appendix G contains a list of the system~oriented unit designations for each 
of the "Tapes" mentioned in this manual, along with the recommended type of 
storage device to which these units should be assigned. 

On the other hand, when speaking in general about saving or 
retrieving data on or from a serial access storage device, the generic term 
"file" will be used. 

2.3 TERMS AND DATA CONVENTIONS 

The words SUBROUTINE and ROUTINE are generally used interchangeably. 
Occasionally the word "LINK" will appear in this manual. It is synonomous 
with SEGMENT. A program SEGMENT is a specific collection of routines used to 
do a specific processing job, such as the calculation of radiation interchange 
factors. Generally, the routines comprising a segment are brought into core 
together, and in this sense, a segment can be thought of as an OVERLAY, where 
that concept is applicable to a particular computer operating system. INTEGER 
and FIXED POINT mean the same thing, as do REAL and FLOATING POINT. 
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The term HOLLERITH* ie applied to atringa of al|4ianumeric 
charactera. The term DATA VALUE will be taken to mean one elcaient of the aet 
of all integera, floating point numbera, and 6-character** Hollerith atringa. 
In the text, DV, DVl, DV2, etc. refer to floating point valuea. NOV, NOVI, 
NDV2, etc. are integer. 

A data value may alao be any arithmetic FORTRAN expreaaion, which may 
contain variable namea. For example: 

ANAME » 6. 8*4. 31 7 /CONI 

ia allowed. On the other hand, function calla auch aa: 

DNAME ■ 4.7* SIN(1.73) 

arc not. The uacr ia alao cautioned to avoid mixed-mode exprcaaiona. 

A data value ahould not be aplit between carda unteaa it ia a 
aubroutine CALL Argument in which caaft a continuation FLAG in Col C muat exiat 
aa in the Standard FORTRAN continuation. 

Integera will be ahown in print aa a aequence of digita preceded, 
optionally, by a plua or minua aign. Floating point numbera will appear in 
print aa a aequence of digita with a leading, trailing, or imbedded decimal 
point, prefixed, optionally, by a plua or minua aign, and auffixed, 
optionally, by an exponent (to the baae 10} denoted aa the letter E followed 
by an integer. Hollerith atringa of charactera will be delineated in print by 
aateriaka. Theae are neceaaary becauae blanka are valid charactera and have > 
apecific binary code (i.e., they do not appear on the printed page, but they 
do appear explicitly in the computer). 


♦The Hollerith code ia actually a binary code for repreaenting alphaunmeric 
charactera on punched carda . Other common binary codea for repreaenting 
alphanurac-ric characters include BCD, ASCII, EBCDIC, and FIELDATA. The use of | 
Hollerith to denote character atringa in general ia purely arbitrary. 

♦♦A 6-character string may be stored in one UNIVAC computer word. TRASYS 
implementations on other computers may provide more or less characters per 
word. In the general case, a Hollerith data value would contain as many 
characters as will fit in one computer word. 
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In addition to DATA VALUES, anothar entity, called an IDENTIFIER, 
REFERENCE FORM, or VARIABLE, will be uaed (in a programing aenae). For 
example, conaider the following atatement: 

?I - 3.14 


In thia caae, 3.14 la a floating point data value, and PI ia an identifier. 
Note that PI ia different from *PI* which ia a Hollerith atring. 

The data field of any card outaide the operationa data or aubroutine 
data blocka may be tetminated by the characer S. Thia terminatea any further 
data read opera:.iona for that card, and allowa the uaer to enter comment data 
to the right of the $. Thia my tempt the uaer to enter a coment to the 
right of it in an otherwiae blank card. Thia reaulta in an empty data field 
and a fatal error. Inac«ad, connent cerda are formatted in the claaaic 
FORTRAN manner, that ia, with a C in card column 1. Such coomienC carda may be 
uaed in any of the data blocka. 

The terma and data conventiona atated thua far hold for all 
aituationa except one. In the operationa data block, a portion of the input 
it in claaaic FORTRAN atatemcnta which are proceaaed only by the FORTRAN 
compiler. Thua, Hollerith information muat be aupplied in a form compatible 
with the compiler. For example: 

a) CALL NDATAS (I, 3HALL,0,2HNO,3HYES) 

FFPNCH “ 3HPUN 

are correct, while 

b) CALL NDATAS (1,*ALL*,0,*N0*,*YES*) 

FFPNCH • *PUN* 

are not, and will reault in FORTRAN errors in subroutines ODPCl, 0DPG2, etc., 
the routines generated from the users operations data block. This situation 
has resulted in a large number of errors over the years end it has been 
alleviated by putting all the Hollerith words conmonly uaed by TRASYS in DATA 
statements in subroutines ODPGl, etc. Thus, the following is allowed: 

c) CALL NDATAS ( 1,ALL,0,N0,YES) 

FFPNCH • PUN 
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Th« user is cautioned chat this approach cannot possibly anticipate 
arbitrarily selected inputs such as configuration nasMS. The cautious user 
has two options: check carefully the reserved word list (Appendix A) for the 

names in DATA statements, or always use the classic "H" fonsat of example a) 
above. The examples supplied herein will always show the H format to 
emphasise this situation. 

A TRASYS "model" is a name (up to 6 characters) used to identify an 
Input deck that has been written to a restart tape. When encountered herein, 
the words "TRASYS model" refer to an input deck, less the options and edit 
data blocks. 

A TRASYS configuration name is used to identify a particular 
geometric configuration defined within a run. If the variable geometry option 
is used, a TRASYS ''model" may have reference to several configuration naoMS. 

2.4 DEFINITIONS 

Albedo: The diffuse reflectivity of a planet in the solar 

waveband . 

Direct irradiation (DI): The thermal energy, in flux units (energy 

per unit time per unit area) incident upon a node. In general, 
direct irradiation consists of solar, planetary and planetary albedo 
components. 

Form factor (FF): The fraction of the total energy leaving a node i 

that reached a node j in a straight line path. 

Gray body factor (GB): The fraction of the energy within a specified 

waveband emitted from a diffusely emitting, diffusely reflecting node 
i that reaches a similar node j by all possible paths. All nodes 
involved in reflections must also be diffusely emitting, diffusely 
reflecting. 
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Heat rate: Tha anargy par unit tina abaorbad by a noda. Tha 

componanta of haat rataa ara diract & raflactad aolar, diract & 
raflactad albado and diract i raflactad planatary infrarad. 

Noda: A finita. ragular portion of a ractangla, polygon, diak, 

cylindar, aphara, cora or paraboloid that ia axpactad to ba 
iaotharaal (avarywhara tha aaaa tamparatura) in tha uaar'a RC 
(raaiatanca-capacitanca) thatmal nodal (intarchangabla with nod/.l 
aurfaca) . 

Optical propart iaa: Tha phyaical propart iaa of a aurfaca that 

intaracta with radiant anargy. Saa Appandix I for dafinitiona of tha 
propartiaa uaad in tha TRASYS thatnal radiation nodal. 

Planatary IR or planatary infrarad: Tha conponent of diract 

irradiation incident on a aurfaca that ia dua to tha thatnal aniaaion 
of the planat'a aurfaca. 

RADK, or radiation conductor: A aingla card imaga raady for input 

into a thatnal analyzer progran that conputaa tamparaturea (a.g. , 
SINDA). The infomation on the card conaiata of a conductor number, 
the numbera of the two nodaa it connacta and tha value of tha 
radiation conductor. 

Radiant interchange factor: Exactly analagoua to a gray body 

factor, except that apacular and apecular-diffuac reflactiona are 
allowed . 
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Shadow factor: In direct irradiation, the quotient of the energy 

incident upon a node and the energy incident upon it if there were no 
intervening surfaces blocking the incoming energy. In form factors, 
the quotient of a form factor and the analogous form factor that 
would exist if there were no intervening surfaces between the two 
surfaces involved. 

Surface: A finite, regular portion of a rectangle, polygon, disc, 

cylinder, sphere, cone or paraboloid. May be subdivided into any 
number of nodes. 
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3.1 INPUT DECK 


3.1 Introduction to the Input Deck 


3.1.1 Basic Concepts 

TRASYS input decks consist of two fundamental parts. Part I consists 
of the EDIT/CONTROL blocks. These blocks do not participate at all in the 
definition of the mathematical model of the thermal radiation problem. This 
part provide basic program control and provides the user with his edit 
capability. Part II is referred to hereinafter as the TRASYS MODEL. This 
part is m^de up of the data blocks that describe the user's problem in terras 
of geometry definition and drive logic. The options and source edit data 
blocks comprise the EDIT/CONTROL portion of the input data. Examples of 
options data are problem title information, restart tape identification, input 
data punch/no punch, list/no list flags and a documentation data list/no list 
flag. A one line (CC7-72) problem title is entered in the options data 
block. This title will appear on each page of output printed by the standard 
library output routines during execution. The Edit Data block allows the user 
to do a line by line edit on previously taped input data. The edit capability 
also allows the user to conveniently merge portions of one or more models into 
his master input model. 

The MODEL portion of the input deck consists of the following blocks: 

Documentation Data 
Array Data 
Quantities Data 
Surface Data 

Block Coordinate System (BCS) Data 
Form Factor Data 
Shadow Data 
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Flux Data 

Correspondence Data 
Operations Data 
Subroutine Data 

In general » the largest block is the surface data. This block is the 
user's means to describe the geometry of the surfaces that participate in the 
radiant interchange of his problem. Because of the surface data block's size, 
a number of input options, differing in format and concept, are provided. 

This allows the user to choose the most convenient means of defining the 
different parts of his geometry; thus easing his most laborious task. 

Another type of data that may comprise a large portion of the user's 
input may consist of information normally considered to be program ouput or 
interim output. A user may have, for example, a large portion of the form 
factors needed for his solution available from some external source. Using 
the form factor data block, he may enter this data and save much processing 
time. 


Another data block that allows the user to take advantage of large 
blocks of previously knoim data is the shadow data block. If DI shadow factor 
cables are known for a portion of this model, the user may enter them through 
this block and avoid computing them in a shadow factor generating run. 

The remaining data blocks used for general alphanumeric input are Che 
correspondence data, array data and quantities data blocks. The 
correspondence data provides Che capability for the user to redesignate node 
numbers, and/or combine a number of nodes into single nodes. The array data 
block provides a convenient input point for any array data that Che user may 
require. Array data may be integer or floating point data value strings, or 
Hollerith strings. The quantities data block performs the same function as 
the array data block except that single values are entered rather than 
strings. If the user desires, he may enter an extended written description of 
his problem in Che documentation block. This will appear at Che user's option 
at the beginning of his printed output and will be stored with Che remainder 
of his input data on his RSO tape. 
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The user's driver logic is entered in Se operations data and 
subroutines data blocks. The operations data block consists of a series of 
calls to user-addressable subroutines and computation segments arranged in a 
series of steps that are used for orderly handling of the output data in 
out-of-core storage. Operations block subroutine calls are primarily used to 
input and update appropriate problem parameters. The calls to the computation 
segments are what actually result in the generation of output data* The 
operations block subroutine calls are in classic FORTRAN format, and the user 
has at his disposal the FORTRAN V language for coding specialized operations 
block logic* In the operations block, the user has access to all variables he 
identified in his array and quantities data, plus an extensive list of program 
variables located in labeled common* 

The subroutines data block contains FORTRAN language subroutines that 
are either user-called or called by the various computation segments. 

Routines found in the subroutines block bearing the same name as processor 
library routines will compile in place of the library routine, thus giving the 
user the capability to override any program function he desires* 

3.1.2 Basic Structure 


The basic structure of the TRASYS input deck is shown in Figure 3-1* 
This figure illustrates the two EDIT/CONTROL blocks and the 11 MODEL blocks in 
their correct input sequence* Format of the header cards that lead each block 
is defined in Figure 3-2* The data blocks must appear in the order shown in 
Figure 3-1. Any block may be omitted, along with its header card if it is not 
required for the problem at hand. 

The EDIT/OONTROL blocks are discussed in Section 3.2; the model data 
blocks in Section 3.3. 
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Figure 3-1 Input Deck Structure 
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3.2 EDIT/CONTROL Pete Blocks 

3.2.1 Options Data Block 

3.2. 1.1 BASIC CONCEPTS 

The Options date block provides the user with the following 
cspebilities and operating options: 

1) An entry point for his problem title and model name 

2) Error plot option control 

3) Source deck list/no list control 

4) Source deck punch/no punch control 

5) Go-No-Go option (No Go for edit only, no execution) 

6) Print/no print for edit directives 

7) Relabel edit directives 

3) Print/no print of documentation data block 
9) Read/write directions for all input and output tapes 
10) Reccmputation point in his operations data logic flow. 

3.2. 1.2 Options Data Block Variables 

Table 3-1 lists the options data block variables together with their 
options, default values, and descriptions. 
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3.2. 1.3 Options Pets Block Exemple 

Figure 3-4 is an example of an options data block. 

3.2. 1.4 Automatic Node Plots Option 

vnien surface data Input rules are violated to the point where any 
surface Is Insufficiently defined to be usablSt a fatal error flag is set and 
the run Is terminated at the end of preprocessor execution. This is 
oftentimes undesirable because the primary objective of the first run on a 
newly defined model Is usually to obtain plots of the problem geometry so that 
the user can visually verify his Input. Time and effort can be saved if the 
surfaces that are usable to the node plotter are plotted In spite of the fatal 
errors. 


The automatic node plot routines eliminate this problem. This 
capability functions as follows: when the word ERPLOT appears in the options 

data block and fatal errors result from the surface data, an operations data 
block is generated by the preprocessor. An example of such ai operations data 
block is shown in Figure 3-3. This example is for a model that uses three 
block coordinate systems. The operations data block generated Is then 
executed and the job terminates. Nct3 that four automatically scaled plots 
are generated for each BCS. The views are from the x, y, and z axes, plus a 
3-D. Also note that any operations data entered by the user is Ignored. 

HEADER OPERATIONS DATA 

BUILD THING, ALLBLK 

CALL NDATAS(l.3HALL,0) 

L NPLOT 

CALL BUILDC(BCS2, 0) 

L NPLOT 

CALL BUILDC(BCS3, 0) 

L NPLOT 

END OF DATA 

Figure 3-3 Sample Operations Data Block Generated for Automatic Node Plots 
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Tat>le 3-1 OoCi^nis Data Input Detail 


Options Data Input 


OC 1 CC 7 

OPTIONS 

DEFAULT 

VALUE 

TITLK 

PROBLEM TITLE IN CARD 
COLUMNS 7-72 INCLUSIVE 

NONE 


= ANY 1-6 CHARACTER 
MODEL NAME 

TH [ NG 


“ NAMEl - LAME 2 

NONE 

RSRK..: 

POSITIVE INTEGER 

0 


rNFO s A 


MAXFL POStTtVE I^^TEGER 64000 


UtSr SOURCE - ACTIVE NONE 

- INACTIVE NONE 

■ all none 

(NOT INPUT) none 

PUW,H SOURCE- ACTIVE NONE 

- INACTIVE none 

■ A^L none 

CNOT INPUT) none 

SAVE SOURCE - ACTIVE NONE 

- INACTIVE NONE 

■all none 

-ACOPER none 

-inoper none 

ALOPER none 

NOGO (INPUT) none 

V. MOT lNt'’TT) NOME 

MO PRINT - EDIT j^OME 

(NOT INPJT) jVONF* 


DESCRIPTION 
PROBLEM TITLE 


PRIMARY MODEL NAME 

CHANGE MODEL NAME I TO NAME 2 

DEFINES THE RSI TAPE RECORD NUMBER BEYOND 
WHICH RECOMPUTING SHOULD BEGIN IF THERE IS AN RSI 
TAPE READ ERROR (SEE SECTION 3. 3. 9. 7: RESTART 

OPERATIONS 


A - PRINT THE INFORMATION DATA FILS 
N - DO NOT PRINT THE INFORMATION DATA FILE 

DEFINES THE FIELD LENGTH (CORE) AVAILABLE 
IN THE COMPUTER (UNIVAC ONLY) 

LIST ACTIVE CARDS IN MODEL 
LIST INACTIVE CARDS IN MODEL 
LIST ALL ACTIVE AND INACTIVE CARDS 
NO LIST 

PUNCH ACTIVE CARDS IN MODEL 
PUNCH INACTI'-’E CARDS IN MODEL 
PUNCH ALL ACTIVE AND INACTIVE CARDS 
NO PUNCH 

SAVE ACTIVE CARDS ON FILE SAVES (SEE MOTE 5) 
SAVE INACTIVE CAROS ON FILE SAVES 

SAVE ALL CARDS ON FILE SAVES 

SAVE ACTIVE OPERATIONS DATA CARDS ON SAVES 

SAVE INACTIVE OPER.3TIONS DATA CAROS ON SAVES 


SAVE ALL OPERATIONS DATA CARDS ON S-AVEC 
EDIT. BUT DO NO PREPROCESS OR PROCESS 
EDIT, PREPROCESS. AND PROCESS 

DO NOT PRINT EDIT DIRECTIVES 
PRINT EDIT DIRECTIVES 


01 - 


Table 3-1 (continued) 




Options Data Input 





DEFAULT 

CCl CC7 

OPTIOMS 

VALUE 

REIaABEL 

(INPUT) 

NOME 


(NOT INPUT) 

NONE 

DMPDOC 

(INPUT) 

NONE 


(NOT INPUT) 

NONE 

RSI 

TXXXX^ 

SEE NOTE 2 

RTI 

TXXXX 

NONE 

RSO 

TXXXX 

SEE NOTE 3 

RTO 

TXXXX 

NONE 

BCDOU 

TXXXX 

BLANK 

CMERG 

- TXXXX 

BLANK 


EMERC 


TXXXX 


BLANK 
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DESCRIPTION 

CHANGE MODIFIER LABEL TO (AA) AND DELETE 
ALL INACTIVE CARDS 

PRINT DOCUMENTATION DATA BLOCK 
NO PRINT 


PROGRAM WILL KEAD RSI TAPE TXXXX IF CONTROL CARD 
ASSIGNMENT IS MADE PRIOR TO EXECUTING PREPROCESSOR 

PROGRAM WILL READ RTI TAPE TXXXX IF CONTROL CARD 
ASSIGNMENT IS vj PRIOR TO EXECUTING PROCESSOR 

PROGRAM WILL WRITE TO RSO TAPE TXXXX IP CONTROL CARD 
ASSIGWlEirr IS made prior to EXECUTING PREPROCESSOR 

PROGRAM WILL WRITE TO F.TO TAPE TXXXX IF CONTROL CARD 
ASSIGNMENT IS MADE PRIOR TO EXECUTING PROCESSOR 

PROGRAM WILL WRITE TO BCDOU TAPE TXXXX WHETHER OR NOT 
BCDOU IS LISTED IN OPTIONS BLOCK IF CONTROL CARO 
ASSIGNMENT IS MADE PRIOR TO EXECUTING WRITE STATEMENTS 
CREATED BY THE USERS* HEADER OPERATIONS DATA BLOCK 

PROGRAM WILL READ CMERG TAPE TXXXX WHETHER OR HOT CHERG 
IS LISTED IN OPTIONS BLOCK IF CONTROL CARD ASSIGNMENT 
IS MADE PRIOR TO EXECUTING PREPROCESSOR AND CMERG EDIT 
DIRECTIVES ARE USED IN THE HEADER EDIT DATA BLOCK 

PROGRAM WILL READ EMERG TAPE TXXXX WHETHER OR NOI SMERG 
IS LISTED IN OPTIONS BLOCK IF CONTROL CARD ASSIGNMENT 
IS HADE PRIOR TO PREPROCESSOR AND EMERG EDIT DIRECTIVES 
ARE USED IN THE HEADER EDIT DATA BLOCK 


Table 3-1 (continued) 


Options Data Input 
CCI CC7 


OPTIONS 


default 

VALUE 


USERl 


TXXXX 


BLANK 


- TXXXX 


TAPE NAME* 


TXXXX 


INTEGER NO. 


SEE NOTE A 


DESCRIPTION 


!SJDE«"o?EKl?iSifMT,SJr ” “S»S' 

MENT*^ ms CONTROL CARD ASSIGN- 

USERS' HEADER OPERATIONS DATA BLOCK t-R-ATED BY 

TXXXX DEPENDENT UPON 
FUTURE AND AUXILIARY APPLICATIONS 

CHANGES NODE ARRAY DIMENSION 
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Table 3-i CcontLnue<>.k 


♦See Appendix G tor additional TAPE/FILE INFORMATION 
NOTES : 


1 UTILIZING THE RSI TAPE AS AN EXAMPLE THE ALLOWABLE FORMS FOR ALL TAPES ARE: 

COL 7 

RSI NO LABEL 

RSI - TXXXX TXXXX IS ANY 6-CUARACTER USER LABEL U.g. , 

TAPE NUMBER). IT WILL BE PRINTED UNDER MODEL 
HISTORY FOR USER ONLY DOCUMENTATION PURPOSES 

RSI - TXXXX SAME AS ABOVE 

u> 

I 

2 KSI MUST ALWAYS BE LISTED IN OPTIONS DATA BLOCK IF IT IS TO BE USED, EXCEPT FOR A RESTART CASE IN WHICH MO 
OPTION DATA BLOCK IS INCLUDED IN DATA DECK BECAUSE THERE WERE NO OTHER REQUIREMENTS FOR IT AND THE ASSIGNED 
TAPE HAS THE MODEL DATA ON IT. 

3 RSO MUST ALWAYS BE LISTED IN OPTIONS DATA BLOCK EXCEPT WHEN AN RSI TAPE HAS BEEN ASSUMED (SEE NOTE 2). 

4 IF INPUT, THE NODE ARRAY WILL BE DIMENSIONED BY EITHER NNMIN OR THE TOTAL NUMBER OF NODES 

DEFINED IN THE SURFACE DATA, WHICHEVER IS LARGER. USED IN CONJUNCTION WITH FFNAC, (SEE SECTION 3.3.5: FORM 
FACTOR data; THE USER MAY UTILIZE FORM FACTORS ON A RSI TAPE CREATED WITH A LARGER MODEL THAN ON THE CURRENT 
RUN. 

1 5 THE SAVES FILE IS NOT AVAILABLE AFTER PROCESSOR EXECUTION BEGINS. FOR THE SAVE OPTION, THE USER’S RUNSTREAM MUST 
COPY SAVES TO A PERMANENT FILE JUST AFTER THE JCL CARD THAT EXECUTES THE PREPROCESSOR. 


' '•vt(.vl>iAL PAGE IS 
OF POOR QUALITY 
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3.2.2 EDIT DATA BLOCK 
3.2.2. 1 Basic Concepts 

Figure 3-5 is a block diagram of the edit portion of the 
preprocessor. Edit logic flow is shown, together with its relationship with 
the remainder of the program. The edit portion consists of the SOURCE EDITOR 
which deletes, inserts, merges, and yanks records and blocks of records to 
form a primary model or input deck. 

The source editor's function is to generate a complete input deck and 
pass it on to the data and logic preprocessors on the DATAI unit. If desired, 
the user may obtain a permanent copy of the DATAI model on an RSO tape. 

Source editing can be done in several ways. The simplest mode is to read the 
user's cards and pass them on as a complete deck on the DATAI unit. 
Alternatively, the user supplied CMERG tape can be passed along directly if 
the CMERG tape is nothing more than the user's cards previously transferred to 
tape. The CMERG u,*“‘t also provides an interface between any user supplied 
input processing routine(s) and the program. In the general edit case, the 
source-edit cards are used to generate an executable model from input data 
found in card form and on the RSI, CMERG, or EMERG units. 

The product of the TRASYS editor is a single TRASYS input deck. This 
is either data selected from an RSI tape, or data in the card input ctream. 
Edits can be in the form of record deletions and record insertions. Records 
for insertions can be obtained from these sources: (1) the card input unit 

(edit data block); (2) the card merge unit - CMERG; and (3) the edit merge 
unit - EMERG. 

The CMERG unit can be single or multifile tape, disk, or drum. The 
data contained on the CMERG unit must be in BCD mode, TRASYS card image form. 
This tvpe of data is usuallv generated by: (1) card-to-tape bv an off-line 
computer; (2) TRASYS processor output to USERl ; or (3) TRASYS input data 
conversion programs. 

The EMERG unit can be a single or multifile tape, disk, or drum. The 
data contained on the EMERG unit must be in the RSO tape format. The EMERG 
file is another RSO output tape from a previous run. 
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Any record or group of records contained in any file on Che CMERG or 
EMERG units can be merged into the primary input deck. Cards to be merged 
into Che primary input deck can be in random order on Che CMERG and EMERG 
units. Note that inserting data from the cards in the edit data block is 
possible only when Che primary input comes from an RSI unit. 

Besides deleting, inserting, and merging cards into the input deck, 
the source editor has the capability of yanking modifications. Each time a 
deck is edited, the inserted and deleted cards are tagged with a modifier 
label and deleted cards are maintained on an inactive status. A **y*nk** 
provides a simple means of returning a model to the condition it was before a 
given modification. For instance, yanking modification "A” will insert all 
cards deleted by "A" and delete all cards inserted by ''A." More than one 
label can be yanked in one run. Cards deleted by a yank are not maintained on 
inactive status. 

3.2. 2. 2 Edit Data Block 

After an RSO tape has been generated, the user will have a source 
listing with edit numbers and edit labels. This tape may then become an RSI 
or an EMERG tape that can be edited according to line numbers in the source 
listing using edit directives in the edit data block. Table 3-II presents 
details of the edit data block directives together with format information. 
Figure 3-6(a) is an example of an edit data block. 

NOTE: Rather than use the input deck on the RSI tape as is; or with 

modification via the Edit Data Block the user may input a complete Input Deck 
in card image form which will be used in place at the input deck on the RSI. 
This could be an alternate way to make changes to the input. 


3-If 


Revision 3 


3. 2. 2. 3 Edic Operations 

Edit operations are illustrated by the following examples, see Fig. 
3*6(b) and 3-6(c): 

1) Input 0 . cards, edits directly from cards and from EMERG and 
CMERG tapes. 

2 ) Input on an RSI tape, edits from cards, EMERG and CMERG tapes. 
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Table 3-11 Edit Data Slock Input Details 

EDiT DATA lltPUT 

(SEE NOTES AT END or TABLE) 


DESOlimON 


*I» HI 

OR 

^INSERT, Nl 

♦D, Nl 

OR 

*DELETE» Nl 

*D, Nl, N2 

OR 

DELETE, Nl, N2 

♦c, ri 

OR 

*CMERC, ri 

♦C, ri, Nl, N2 
OR 

*CMERC, PI, Nl, N2 

♦C, FI, Nl, ALL 

OR 

*CMERC, FI , Nl, ALL 

*E, NAME 
UR 

*EMERC, NAME 
*EKERC, NAME Nl , N2 
*P 

OR 

♦PUNCH 

*P, INACTIVE 
OR 

♦PUNCH, INACTIVE 

♦P, ALL 

OR 

PUNCH, ALL 
♦L 

OR 

♦LIST 


THE CARDS FOLLOWING THIS CARD WILL BE INSERTED AFTER EDIT NUMBER -Hl- 

DELETE PRIMARY DECE CARD WITH EDIT NUMBER Hll- 

DELETE PRIMARY DECE CARDS WITH EDIT NUMBERS -Nl- THROUGH -N2- 

IH8ERT THE ENTIRE CARD FILE -FI- PROM WIT -CMERG- AT THIS POINT IN THE INPUT DICE 

INSERT LINES Nl THROUGH N2 FROM CMERG FILE PI AT THIS POINT IN THE INPUT DECE 

INSERT ALL LINES EIOM Nl TO END (V CMERC FILE FI AT THIS FOINT IN TIE INFITT DECK 

INSERT THE ENTIRE EDIT DECE, - NAME- FROM UNIT -BMERC- AT THIS FOOT IE IIS IHFOT BECE 

MERGE LINE Nl THROUGH LINE H2 OF EDIT DECS *HAME- AT THIS FOOT IH TIB IIFU T DECS 
FUNCI ACTIVE CAROS FROM THE UNDATED DECE (SEE MOTE 3) 

rUNCH INACTIVE CARDS FROM THE UNDATED DECE (SEE NOTE 3} 

NUHCH ALL ACTI7E AMD INACTIVE CARDS FROM THE UNDATED DECE (ED MOTE 3) 

LIST ACTIVE CARDS FROM THE UNDATED DECE 


Table 3-II <concl) 


EDIT DATA IRrUT 
(SEE MOTES AT 

EMD or TABLE ) Deacription 

•L, INACTIVE LIST INACTIVE CAEDS PNOM THE UPDATED DECE 

OB 

*LIST, INACTIVE 

*L, ALL 

OB 

•LIST, ALL 
*S 

OB 

•SEQUENCE 
•T, AB 
OB 

•TANE, AB 
•T, AB, AO 

OB 

•TAME, AB, AO 
NOTES: 

1. AN ASTEBISE (*) IN CABO OOUMI 1 OBSIGNATES AM EOIT OONTBOL CABO. 

2. EOIT CONTBOL CABOS ABE PBEE PIELO POBMATEO IN CABO COLUMNS 2 TEB006H 72 WITH BLAME COLINIMS 
AMO COLUMNS 73 THBOOCH 80 ICNOBEO. 

3. THIS CABO MAT BE U8E0 IN PLACE OP THE -PUNCH SOUBCE-OPTION IN THE OPTIONS DATA BLOCE. IP BOTH CABDS 
ABE INPUT, THIS CABO OVEBBIOBS THE OPTIONS OATA INPUT. THIS CABO MAT APPEAE AMYHHEBE IN 

THE EOIT DATA BLOCE. 

A. ONLT ONE TANE OIBECTIVB CAN APPEAB IN THE EDIT OATA BLOCE, AND THAT CABO MUST OMEOIATELT POLUM 
THE -HEADEB EDIT DATA- CABO. 

5. A PEIMABT DECE IS THE INPUT DECE (ON A BSl TAPE) TO WHICH ALL IHSEBT A DELETE LINE NUMBEBS 
BEPEB (•! and *D CABDS ONLT) 

6. •C and *B CABDS ABE NOT BESTBICTED TO THE EOIT DATA BLOCE. TRET MAT ALSO APPEAB AT ANT POINT IN THE 
INPUT DECE WHIEE THE MATEBIAL THET INSERT IS APPBOPBUTE. 


LIST ALL ACTIVE AMD INACTIVE CABDS PROM THE UPDATED DECE 

MUMEBICALLT SEQUENCE PUNCHED CAROS. THIS CARD MAT APPEAB AMTHHERE IN THE EDIT DATA BLOCE 

DELETE ALL CARDS PROM PRIMABT DECE THAT MERE IM8E1TBO BT EOIT DIRECTITE -AB- (SEE NOTE A) 

DELETE ALL ^:ARDS PROM PRIMABT DECE THAT HERE INSERTED BT SOURCE EDIT DIRECTIVES 
-AB- THROOOi -AO- (SEE NOTE A) 
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HEADER OPTIONS DATA 

TITLE EDITOR CHECK OUT-EXAMPLE I 

MODEL - DATAl i DAFAl - MODEL NAME THAT WILL APPEAR ON RSO TAPE 
EMERG - TXXXX 
CMERG - TXXXX 
RSO - TXXXX 
HEADER SURFACE DATA 

(SURFACE DATA CARDS) 

C INSERT CARDS 199 THRU 998 FROM EMERGE MODEL SURFDl INTO SURFACE 
C DATA BLOCK 

♦EMERG, SURFDl, 199,998 

(ADDITIONAL SURFACE DATA CARDS) 

HEADER FORM FACTOR DATA 
C INSERT FILE 4 FROM CMERG TAPE 

♦CMERG, 4 

HEADER FLUX DATA 

(FLUX DATA CARDS) 

HEADER OPERATIONS DATA 

C INSERT PART OF FILE 2 FROM CMERG TAPE 

*C,2,1,39 

END OF DAT.. 

(b) Edit Or^rations ExaiapLe - Model on Cerda 


Figure 3-6 (con't) 
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HEADER OPTIONS DATA 

TITLE EDITOR CHECK OUT EXAMPLE 2 

MODEL • DOCKl - DOCK2 $ DOCKl - RSI MODEL NAME 
C DOCK2 ■ RSO MODEL NAME 

EMERG - TXXXX 
CMERG - TXXXX 
RSI - TXXXX 
RSO - TXXXX 


HEADER EDIT DATA 


★D.2,6 


(CARDS TO BE INSERTED IN LIEU OF CARDS 2 THRU 6) 


*I,ll 


(CARDS TO BE INSERTED AFTER CARD U) 

*1,340 iCARD FOLLOWING INSERTS CARD 312 THRU 450 FROM MODEL DOCKA 
C ON EMERG AFTER CARD 340 
*E, DOCKA, 3 12, 450 


(c) EdiC Operacions Example - Model on RSI Tape 


Figure 3-6 (cone I ) 


3-22 


Rtvitlon 3 


3.3 DATA BLOCKS 


3.3.1 Documentation D«f 


Experience hee eho«m that thermal mathematical models may have an extended 
useful life, especially if tape storage with convenient editing capability is 
available. The usual environment of sketchy and rarely updated documentation 
results in a waste of resources as these long-lived models are passed from 
analyst to analyst through project personnel changes. 

As an aid in alleviating this problem, TRASYS users isay document their 
efforts in an easily edited and easily accessed form in the documentation data 
block. 

The documentation data block has the following format: 

CCl CC7 CC7 

2 

HEADER DOCUMENTATION DATA 

Documentation Data Card 1 
Documentation Data Card 2 


Documentation Data Card N 

Documentation data cards have a data field from CC7 through 72 inclusive and 
have no restriction on their alphanumeric content. There is no practical 
limit on the number of documentation cards allowed. 
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The control field of documentation date cards is used for carriage 
control. The integer N appearing anyvhere in CCl through 6 of a documentation 
data card results in N lines being skipped before printout of that card. If 

less than N lines are available on a page, the card will begin a new page. If 

a new page is desired, the letter P is placed in CCl. A dociasentation data 
printout is available at the user's option. The flag DMPDOC appearing in the 
options block results in s printout of the document ition data prior to any 
preprocessor or processor operations. 

3.3.2 Quantities and Array Data Blocks 

3.3.2. I Basic Concepts 

The quantities and array data blocks have che primary function of 
providing the user with a convenient input point for any single variable and 
array data he plans to use during his execution. User constants are defined 
in the quantities data block and arrays in the array data block. A user 

variable or array may take any name not appearing in the program reserve name 

list or program control constant list (see Appendix A). Real, integer, or 
Hollerith data may be entered. Mode agreement is required for real and 
integer data names. Hollerith strings are limited to 6 characters in the 
quantities data block. 

The pre-processor provides default values for all program control 
constants, so no control constant input is required in the quantities data. 
Further, all control constants can be redefined in the operations block. 

Thus, defining control constants at the quantities data block merely has the 
effect of redefining the default values. In general, this practice is not 
recoonended because it is easy for the user to forget that he has i 
non-standard default value in his quantities data block when he is defining 
control constants in the operations data block. 
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3 . 3 . 2 . 2 Rules for Input 

All qusricicies end srrey decs ere entered in the deta field (Coluons 
7 through 72) of the csrds following the eppropriete header card. Specific 
rules for input are: 

1) Ttie genetal quantity data formats are: 

NAME ■ DV, (integer) 

ANAME - DV, (real) • 

NAME (or ANAME) “ DV where DV is a 1 to six character 
string. (Left justified, blank filled) 

2) The general array data formats are: 

NAME • DVl, DV2 DVN (integer) 

ANAME • DVl, DV2 - - DVN (real) 

NAME (or AHAME) - *I AM A HOLLERITH ARRAY* (Hollerith) 

3) Array data values may be operated as follows: 

NAME - DVl, REPEAT, DV2, N, DVN->2 (Repeats DV2 N times, 
continues with DVN^2) 

Real array repeat format is identical. 

4) Variable names must consist of 3 to 6 alphanumeric characters, 

with an alphabetic character heading. 

5) Any number of quantities or array data values and names may be 
entered in Card Columns 7 through 72 inclusive. Input may 
continue to following cards with no data in the control field, 
provided the fields between consaaa are complete on each card. 

6) Comas are assumed at the end of each card. Comas may be 
entered at the beginning or end of cards at Che user's option. 
The read routine ignores these. 
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7) May end but not begin with equal signs* 

8) Empty fields (consecutive cooinas) are illegal* 

9) Mode agreement between names and data values must be maintained* 

3.3*2. 3 Quantities and Array Data Accessing 

Quantities and array data are placed in common and are thus 
accessible from any user or program-called execution routines. The following 
are the rules for accessing this data: 

1) Quantities data are accessed by name only. 

For example t with 

ANAM * DV, 

in the quantities block, the statement 
VAL = ANAM 

in any execution routine results in DV being stored under the 
name VAL. Mode must be preserved according to the rules of 
FORTRAN. 

2) Array data is accessed as illustrated by the following examples. 
Each example presximes that the array: 

ANAM * DVl, DV2 DVN 

appears in the array data block. 

A. SUBROUTINE CALLS 
The statement: 

CALL SUBX (ARGl, ARG2, ANAM, ARG4 ) 

in any execution routine will P' jS the entire ANAM array 
to subroutine SUBX*, 
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B. INTEGER COUNT 

The integer count for any array is accessed through the 
following function c£.ll: 

IC - lACT (ANAM) 

C. INDIVIDUAL DATA VALDES 

Individual data values are accessed under the usual rules of 
FORTRAN. The statement: 

VAL » ANAM(6) 

results in DV6 being stored under the name VAL. 


3) The array data block serves as the only means of reserving space 

for the operations data block. The following example illustrates 
this with: 

ANAMA » DVl, DV2, DVN, 

XARRAY = REPEAT, 0., N 
in the array data block, the statements: 

DO 1 I = 1, IC 
1 XARRAY (I) = ANAMA (I) 

in the operations data block will locate the ANAMA array in the 
first 1C words of XARRAY. 
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Intentionally left blank. 
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3.3.3 SURFACE DATA 
3.3.3. 1 BASIC CONCEPTS 


In its present state of development, TRASYS allovs the user's 
geometric configuration to be made up of the follotring geometric shapes, or 
portions thereof: 

(1) Rectangles 

(2) Discs 

(3) Polygons 

(4) Right Circular Cylinders 

( 5 ) Cones 

(6) Spheres 

(7) Paraboloids 

(8) Rectangular Parallelepipeds with 5 or 6 faces 

(9) Soheroids (Oblate or Prolate)* 

(10) Toroids* 

(11) Ogives* 

(12) Structural Elements* 

(13) Structural Tapes* 

The surface areas of these shapes are wliat TRASYS is concerned with. 
Either or both sides of any surface can be defined as "active." Also, any 
surface can be defined as a "shadower" or "non shadower" depending on whether 
or not it is desired that it be considered in shadowing (blockage) 
calculations. 

"Structural Elements" are right circular cylinders that are complete 
(a circumferential portion is not allowed) and has a length to diameter ratio 
greater than 10. "Structural Tapes" are rectangles with an aspect ratio 
greater than 10. Structural Elements are active only on the outside, while 
tapes are automatically active on both sides. 


* Not available on Univac 
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The active side concept is illustrated in the sketch* If form 
factors were computed in this ge<xnetry, and would exist because the 

active sides involved are in view of each other. No F^ form factor will be 
computed, because surface A cannot see the active side of surface B. 

Again referring to the sketch, if surface B is defined as a shadower 
in form factor computations, it will affect the calculation of reducing it 

accordingly. If not entered as a shadower, it would be totally "invisible” 
from surface A. Active side definition has no bearing on a surface's effect 
as a shadower. One further condition must exist for surface B to affect the 
value of F^^, that is surfaces A and C must be flagged as "can be shaded" 

surfaces in form factor calculations. 

A similar logic is used in computations of direct irradiation. 

Surfaces defined as shadovers may affect the direct irradiation computed 
depending on direction to the incident flux source. 

Since all surfaces in nature can shade and be shaded, it may seem 
questionable to leave the shadowing definition up to the user. The reason for 
this is that significant amounts of computation time can be saved by flagging 
out surfaces that cannot enter into shadowing. It is also advantageous from 
the standpoint of computation time to minimize the number of surfaces to 
define a given configuration and nodal breakdown. 

Any surface may be subdivided into nodal surfaces of equal or unequal 
size. When the nodal surfaces chosen are a subset of the thermal analyzer 
math nwdel, there is a convenient means provided for combining the TRASYS 
nodes to correspond with the thermal math model. 


3-30 


Revision 3 


3.3*3*2 Coordinate System Definition 

The surface data is associated with four different » right-handed 
cartesian coordinate systems: 

Surface coordinate system 

Intermediate coordinate system 

Block coordinate system 

Central coordinate system 

Their definitions are as follows: 

Central Coordinate System (CCS) - This is the single coordinate 
system to which all vehicle surfaces must be related. This coordinate system 
is also used to orient the spacecraft relative to the sun, planet, or a star. 
This coordinate system is analogous to the body coordinate svstem used in 
trajectory tapes. 

Block Coordinate System (BCS) - Any "block” of surfaces that will be 
moved relative to other surfaces during execution must be related to a named 
block coordinate system. Similarly, if it is desired to activate and/or 
deactivate a block of surfaces during the course of the problem, these 
surfaces are related to a separate block coordinate system. 

Intermediate Coordinate System (ICS) - An intermediate coordinate 
system is used when it is convenient to relate a group of surfaces to a 
coordinate system distinct from any BCS or the CCS. 

Surface Coordinate Svstem (5CS) - Each surface is related to its own 
SCS in a manner that provides a convenient means of input, '^he surface must 
then be related to the CCS by defining the rotations and translations 
necessary to make the SCS and CCS coincide. 
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3. 3.3.3 Coordinate System Hierarchy 

Each surface and hence nodal surface defined in the surface data 
block may undergo three transformations, as follows, before processing begins: 

SCS — ^ ICS BCS — w* CCS 

where, for example the symbology SCS— ICS indicates a transform from 
SCS-defined 3-space to ICS defined 3-space. These transforms must be 
performed because all processing is done assuming surface definition in 
CCS-defined 3-space. 

Depending on the complexity of each particular surface definition 
problem, the user may or may not concern himself with all the transforms. In 
the simplest case, the user defines a surface in terms of x, y, z coordinates 
in CCS 3-space. The program automatically generates an SCS for each surface 
and also generates the transforms necessary to describe the surface in CCS 
3-space. In the most complex case, the user defines his surface in SCS 
3-space, defines six rotation and translation variables for the SCS ► ICS 
transform, defines six rotation and translation variables for the ICS— BCS 
transform, and finally six more variables for the BCS— CCS transform. For 
cases of intermediate complexity, for instance when an ICS is not needed, the 
ICS BCS transform variables will default to zero and the user's SCS — » ICS 
transform variables will, in reality define an SCS— ^ BCS transform. 

Further, if neither an ICS or BCS is required, the SCS —►ICS and ICS — ► BCS 
transforms will default to zero, and the user's SCS ICS transform 
definition will, in reality, define an SCS —►CCS transform. 
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3,3*3«4 Surface Data Input Philosophy 

The user is provided with two distinct methods of defining his 
surface* He may define a surface relative to an SCS, then relate it to the 
remainder of the surfaces by defining the SCS-CCS translations and rotations; 
or he may locate the surface directly in relation to the CCS by entering the 
Xy Yf z coordinates of up to 19 points on his surface (point method). His 
choice of these methods depends on the particular surface being considered and 
its relationship to the remainder of the vehicle. In general) it is easy to 
define a surface relative to an SCS. This requires five numbers. It may or 
may not be convenient to determine the translation and rotation data (up to 6 
numbers) needed for the SCS — ^ICS, SCS — BCS, or SCS — CCS 
relationship. When the computation of these rotation and translation 
parameters is laborious, the point method is usually a better choice. Except 
for polygons, this requires up to 6 point definitions per surface (18 
numbers), but generally these points are on the surface involved and may be 
easily scaled from an engineering drawing. 

3.3. 3.5 Surface Data Variables 


The variable names devoted to surface data definition are defined in 
Table 3-III. Also tabulated are their default values, and the allowable range 
of each variable, where applicable. Figure 3-7 illustrates the relationship 
of the dimension surface data variables to each geometric figure. Both the 
surface coordinate system methods and point methods of input are shown. A 
careful study of Table 3-III and Figure 3-7 will pay dividends to the new 
TRASYS user. 
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Table 3-1 1 i Surface Data Input Detail 


RANGE OR 


VARlAhLti NAMK 


OPTIONS 

DEFAULT VALUE 

DESCRIPTION 

GKNERAL DATA: 
SUREN 




(REF. Fig 3-10) 


1-99999 

NONE 

a. INTEGER ARRAY OF NODE NUMBERS 
ASSOCIATED WITH SURFACE 

b. INITIAL NODE NO. ON SURFACE 


NNX 


1-999 

1 

NO. OF NODES IN X DIRECTION 

UNNX 

0 < 

UNNX ^(XMAX-XMIN) 

NONE 

X-DIMENSION ARRAY FOR UNEQUAL NODE 
BOUNDARIES 

NNY 


1-999 

1 

SAME AS NNX EXCEPT Y-DIRECTION 

UNNY 

0 . < 

UNNY ^ (YMAX-YMIN) 

NONE 

SAME AS UNNX EXCEPT Y-DIRECTION 

NN2 


1-999 

1 

SAME AS NNX EXCEPT Z-DIRBCTION 

UNNZ 

0. < 

UNNZ <(ZMAX-ZMIN) 

NONE 

SAME AS UNNX EXCEPT Z-DIRECTION 

NNAX 


1-999 

1 

SAME AS NNX EXCEPT AX-DIRECTION 

UNNAX 

0 , < 

UNNAX <( AXMAX-AXMI N ) 

NONE 

SAME AS UNNX EXCEPT AX-DIRECTION 

NNl 


1-999 

1 

SAME AS NNX EXCEPT R-DIRECTION 

UNNR 

0. < 

UNNR ^(RK^X-RMIN) 

NONE 

SAME AS UNNX EXCEPT R-DIRECTION 

NNTH 


1-999 

1 

NUMBER OP NODES AROUND TOROID CROSS-SECTION 

UNNTH 

0* < 

UNNTIl < (THMAX-THMIN) 

NONE 

THETA-DIMENSION ARRAY FOR UNEQUAL NODE 
BOUNDARIES AROUND TOROID CROSS-SECTION 

TYPE 


RECT, TRAP 

NONE 

SURFACE TYPE 



DISK, C'L 
CONE. SPHERE 
PARAB, BOX5 
BOX6 , f OLV 
SPllERO*, OGIV* 
TOR*, ELEM*, TAPE* 
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Table 3-III Suiface Data Input Detail (cont) 


RANGE OR 
VARIABLE NAME 


general DATA: 
IDUPSF 


OPTIONS 


DEFAULT VALUE 


description 


1-99999 

SURFACE TO BE DUPLICATED 


NONE 


( REF. Fig 3-10 ) 

NUMBER OF PREVIOUSLY INPUT 


IMAGSF 

1-99999 

SURFACE TO BE IMAGED 

NONE 

NUMBER OF PREVIOUSLY INPUT 

ACTIVE 

TOP, BOTTOM 
BOTH (PLANAR 
SURFACES) 


ACTIVE SIDE DEFINITION 

SCS METHOD: TOP - +Z FACE OF 

PLANAR SURFACES 


IN, OUT, BOTH 
(SURFACES OF REV- 


POINT METHOD: REF. FIGURE 3-; 


OLUTION, AND BOXES 

NONE 


BCSN 

1-6 CHARACTER NAME 

ALLBLK 

BLOCK COORDINATE SYSTEM NAME - 
IDENTIFIES SURFACE WITH A BCS 

COM 

N/A 

BLANKS 

30 CHARACTERS OF COMMENT TO 
describe SURFACE 

SHADE 

FF, DI, BOTH, 
NO, ONLY 

BOTH 

**FF 

SURFACE CAN SHADE FLAG 


FF: SHADES IN FORM FACTOR 

CALCULATIONS ONLY 

DI: SHADES IN DIRECT IRRADIATION 

CALCULATIONS ONLY 
BOTH: SHADES IN BOTH FF AND DI 

CALCULATIONS 

NO: SURFACE CANNOT SHADE 

ONLY: SURFACE IS A SHADOUER ONLY 

(FF AND DI) 
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Table 3-1 II Surface Data Input Detail (cont) 


RANGE OR 




VARIABLE NAME 

OPTIONS 

DEFAULT VALUE 

DESCRIPTION 

GENERAL DATA: 



(REP. Fig 3-10) 

BSHADE 

FF, DI, BOTH, NO 

BOTH 

SURFACE CAN BE SHADED FLAG 


FF: CAN BE SHADED IN FF 

CALCULATIONS ONLY 
DI: CAN BE SHAI^D IN DI CALCULA- 

TIONS ONLY 

BOTH: CAN BE SHADED IN BOTH FF AND 
DI CALCULATIONS 

NO: SURFACE CANNOT BE SHADED 



N/A 

NONE 

LENGTH OF SPHEROID SEMI-AXIS IN 
PLANE OF SCS 

B* 

N/A 

NONE 

LENGTH OF SPHEROID SEHI-AXIS ALONG 
SCS Z-AXIS 

AXMIN 

-2/0. ^ AXMIN < 450. 

NONE 

NIN. X-ANGLE 

SURFACES OF REVOLUTION 

AXMAX 

-270. AXMAX ^450. 

NONE 

MAX. X-ANGLE 

ZMTN 

N/A 

NONE 

MIN. DIMENSION - Z DIRECTION 

ZHAX 

N/A 

NONE 

MAX. DIMENSION - Z DIRECTION 

RMIN 

N/A 

NONE 

MINIMUM RADIUS - DISK SECTION 

RHAX 

N/A 

NONE 

MAXIMUM RADIUS - DISK SECTION 

K 

N/A 

NONE 

RADIAL DIMENSION 

THMIN’’^ 

-270.£THMIN <450. 

NONE 

MIN. ANGLE AROUND TOROID CROSS 
SECTION 

THMAX* 

-270.^THMAX ^ 450. 

NONE 

MAX. ANGLE AROUND TOROID CROSS 
SECTION 
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Table 3-III (continued) 

RANG£ OR 

VARIABLE NAME OPTIONS DEFAULT VALUE DESCRIPTION 


DIMENSION DATA: 


2 

N/A 



NONE 

Z DIMENSION 

PI, P2 - 

ETC. PI - P19 



NONE 

CARTESIA*' POINT INPUT (GENERAL 
FORM: PN > XN. YN, ZN) 

PROPERTIES 

DATA: 





AI-PHA 

0. ^ ALPHA ^ 

1.0 


NONE 

ABSORPTIVITY - SOLAR 

EHISS 

0. ^ EHISS ^ 1.0 


NONE 

EMISSIVITY - IR 

TRAN I 

-l.O^TRANl < 

l.O 


0.0 

TRANSMISSIVITY - IR 


i.o:£trani » 

A WHOLE 

NUMBER 

0.0 

INDICATES THE INPUT SEQUENCE NUMBER 
OP A DOUBLET ARRAY OF INFRARED 
TRANSMISSIVITY VERSUS ANCLE OF 
INCIDENCE** 

TRANS 

-l.O^TRANS < 

l.O 


0.0 

TRANSMISSIVITY - SOLAR 


I.O^T'IANS = 

A WHOLE 

NUMBER 

0.0 

INDICATES THE INPUT SEQUENCE NUMBER 
OF A DOUBLET ARRAY OF SOLAR TRANS- 
MISSIVITY VERSUS ANCLE OF 
INCIDENCE** 

SPRl 

0. ^ SPRI ^ 

l.O 


0.0 

SPECULAR Rf : LECTIVITY - IR 

SPRS 

0. < SPRS < 

1.0 


0.0 

SPECULAR REFLECTIVITY - SOLAR 
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Table 3-111 (continued) 

RAHGE OR 

VARIABLE NAME OPTIONS 


DEFAULT VALUE DESCRIPTION 


POSITION DATA: (NOT APPLICABLE TO POiNT METHOD INPUT) 


TX 

N/A 

0.0 

TV 

N/A 

0.0 

vz 

N/A 

0.0 

ROTX 

-360. < ROTX < 360. 

0.0 

ROTY 

-:i60. < ROTY < 360. 

0.0 

ROT 7 

-360. < ROTZ < 36C. 

0.0 


TRANSLATION DISTANCE FROM ORIGIN OF 
CCS, BCS OR ICS TO ORIGIN OF SCS, 
MEASURED ALONG CCS, BCS, OR ICS 
X-AXIS. 

SAME AS TX, EXCEPT ALONG Y-AXIS 

SAME AS TX, EXCEPT ALONG Z-AXIS 

ROTATION ANCLE TO ROTATE CCS, BCS 
OR ICS INTO SCS; ROTATES ABOUT CCS, 
BCS OR ICS X-AXIS, Y TOWARD Z 
POSITIVE 

SAME AS ROTX, EXCEPT ROTATES 
ABOUT Y, Z TOWARD X POSITIVE 

SAME AS ROTX, EXCEPT ROTATES 
ABOUT Z, X TOWARD Y POSITIVE 


fCS DEFINITION 

(I CARD) DATA: (MUST PRECEDE ALL S-CARDS) 

ICSN 1-99999 NONE 

TX N/A 0.0 

TY N/A 0.0 


INTERMEDIATE COORDINATE SYSTEM NUMBER 

TRANSLATION DISTANCE PROM ORIGIN OF 
CCS OR BCS TO ORIGIN OF ICS, MEASURED 
ALONG CCS OR BCS X-AXIS 

SAME AS TX, EXCEPT ALONG Y-AXIS 


0.0 


I/. 


N/A 


SAME AS TX, EXCEPT ALONG Z-AXIS 
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Table (concluded) 

RANGE OR 

VARIABLE NAM H] OPTIONS 

ICS DEFINITION 
(I CARD) DATA: 

-360. < ROTX ^ 360. 


•^OTY -360. < ROTY ^ 360. 

-360. < ROTZ < 360. 


R-CARD DATA: 
REFNO 

D-CARD DATA: 
DV 

N-CARD DATA: 
INC 


1-99999 


FLOATING POINT 


INTEGER 


DEFAULT NANE DESCRIPTION 


ROTATION ANGLE TO ROTATE CCS OR BCS 
INTO ICS; ROTATES ABOUT CCS OR BCS 
X-AXIS, Y TOWARD 2 POSITIVE 

SAME AS ROTX, EXCEPT ROTATES ABOUT 

Y, Z TOWARD X IS POSITIVE 

SAME AS ROTX, EXCEPT ROTATES ABOUT 

Z, X TOWARD Y POSITIVE 


NUMBER OF REFLECTING PLANE SURFACE 


LENGTH UNIT MULTIPLIER 


SURFACE NUMBER CHANGE VALUE 
(SURFN =* SURFN + INC). 


*Not available on Univac version. 


If the surface has a component of specular reflectance 
ified or set to "NO," the flag is reset to "FF." If the 
(Specular surfaces must be shadowers in the FF segment. 


and the can-shade flag 
flag is set to "DI" it 


is either unspec- 
is reset to "BOTH 



/ 


/ 


r 







EXAMPLE: PI ” Xl, Yl, Z 

P2 - X2, Y2, Z 

NNY - 2 

NNAX - 2 


SCS 

METHOD 


SCS 

ORIGIN 


MOTE: TRAPEZOID IS ALKAYS GENERATED 

FROM PI TOWARD P2 IN X TOWARD Y 
DIRECTION. PARALLEL SIDES OF 
TRAPEZOID MUST BE PARALLEL TO 
SCS X-AXIS. TRIANGLES ARE INPUT 
AS POLYGONS. 


THE FOLLOWING INPUTS ARE 
NOT ALLOWED (EITHER METHOD): 

MX, UNNX, NNZ, UNNZ, NNR, UNNR, 
DIMENSIONS, OR PN WITH N 
GREATER THAN 4. 


POINT METHOD 

(POSITION DATA NOT 
ALLOWED) 


CCS, BCS OR ICS 
ORIGIN 



/ 


EXAMPLE; 
PI = X 


XI. 

Yl, 

Z1 

X2, 

Y2, 

Z2 

X3, 

Y3, 

Z3 

X4, 

Y4, 

Z4 


NOTE: POINTS ARE NUMBERED CCW 

AROUND FIGURE AS VIEWED 
FROM THE "TOP" SII® OF 
THE SURFACE. P1-P4 MUST 
BE SHORTER THAN AND 
— Y PARALLEL TO P2-P3. 

FOR A TRIANGLE, PI 
AND P 4 ARE ENTERED AS 
DUPLICATE POINTS 


*"Sur£ace" coordinate aysceo as generated by 
program. 


Trapezoid Figure 3-7 (cort) 
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I 


NOTE: 


8CS 

METHOD 


EXAt_'LES: 



ALLOWED (EITHER METHOD) : 

NNX, UNNX, NNY, UNNY, NNR, UNNR 
OR PN WITH N GREATER THAN 4. 


POINT 

METHOD 

(POSITION 

ALLOWED) 



SURFACE GENERATED FROM P2 TO P3, CCW ABOUT AXIS AS VIEWED FROM PI END 


Cylinder Figure 3-7. (cont) 
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T 


SCS 

METHOD 


SCS 

ORIGIN 


POINT 

METHOD 

(POSITION DATA NOT 
ALLOWED) 



EXAMPLES; 

DIMENSIONS 

NNZ 

m 

2 

NNAX 

m 

2 

OR: 

R 

m 

20. 

ZMIN 

m 

11. 

ZMAX 

m 

15. 

AXMIN 

m 

52. 

AXMAX 

m 

60. 

NNZ 

m 

2 

NNAX 

m 

2 


ALTERNATE 


THE FOLLOWING INPUTS ARE 
NOT ALLOWED (EITHER METHOD) : 

NNX, UNNX, NNY, UNNY, NNR, UNNR, 
OR PN WITH N GREATER THAN 6. 


6 POINT INPUT 
NNAX - 2 
NNZ - 2 


NOTES: o PI defines the "North Pole" of the sphere. 

o P2 and P3 define the equatorial plane of the sphere and the extremities 
of the active portion of the sphere in the angular direction about the 
polar axis. Surface is generated from P2 to P3 CCW as viewed from 
PI toward P4, 

o P4 defines the center of the sphere. 

o P5 and P6 mu: t lie on the longitudinal line defined by PI and P3. P5 
and P6 define the extremities of the active portion of the sphere as 
measure j along the polar axis. 

0 All six points must be input for any partial definition of a spherical 
Surface. 

o A complete sphere is generated from 3 points; PI - North Pole, P2 - 
Center, P3 - Point on Equator where node generation begins. 

* "Surface" coordinate system as generated by program. 


SPHERE Figure 3-7 (cont) 
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METHOD 


P2 





NOTE: PI, P2 AND P3 MUST ALL LIE OH SAME FACE OF 

FIGURE, WIT'l P4 DIAGONALLY OPPOSITE PI. FACE 
CONTAINING Pi, P2 and P3 DELETED FOR 5-SIDED BOX. 


5 & 6 SIDED BOXES Figure 3-7 (cont) 





PI defines the "North Pole" of the spheroid. 

P2 and P3 define the equatorial plane of the spheroid and the extremities 
of the active portion of the spheroid in the angular direction about the 
polar axis. Surface is generated from P2 to P3 CCW as viewed from 
PI toward P4 , 

P4 defines the center of the spheroid, 

P5 and P6 must lie on the lon,»ltudinal line defined by PI and P3. P5 
and P6 define the extremities of the active portion of the spheroid as 
measured along the polar axis* 

All six points must be input for any partial definition of a spheroidal 
surface. 

A complete spheroid is generated from 3 points: PI - North Pole, P2 - 
Center, ?3 * Point on Equator where node generation begins. 

"Surface" coordinate system as generated by program. 


Not available on Univac 


OBLATE OR PROLATE SPHEROID Figure 3-7 (cont) 
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Method 


TWIAX 




ons “ 6 . , 3 
5., 90., 45 
2 
2 

atively: 

6 . 

34. 

Ub. 

90. 

45. 

60. 


"ail 




l»1 


NOTES: Line P2-P1 must be perpendicular to line P4-P1 

and all or part of the active surface must lie 
between P2 and PA. 

A complete toroid is generated frcm 3 points 
as shown in sketch. Node generation begins 
at P2 toward P3. Input should be such that 
the angle P2-P1-P3 is in the range of 45° to 90° 


Not available on Uni vac 


TOROID Pigure 3-7 (cont) 
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S true tural Element 



Inputs Not Allowed: /OCMIN, AXMAX, NNAX, UNNAX, Active - IN, Any 

Dimension or Position Data 



Surface Is Active on Both Sides Regardless of Active 
Definition. 


Inputs Not Allowed: NNY, UNNY, Any Dimension or Position Data. 


Not available on Univac 


STRUCTURAL ELEMENTS AND TAPES Figure 3-7 (cent.) 



THE FOLLOWING INPUTS ARE NOT 
ALLOWED: 

NNX, UMMX, NNY, UNNY, NNZ, UNNZ, 
NNR, UNNR, DTtmSimS, POSITION, 
OR PN WITH N GREATER THAN 19. 


CCS, BCS OR ICS 
ORIGIN 




EXAMPLE: 



PI 

m 

XI, 

n. 

Z1 

P2 

m 

X2, 

Y2, 

Z2 

P3 

m 

X3, 

Y3, 

Z3 

P4 

m 

X4, 

Y4, 

Z4 

P5 

m 

X5, 

Y5, 

Z5 


NOTE: POINTS MUST BE NUMBERED IN 

CONSECUTIVE ORDER ABOUT FIGURE, CCV 
AS VIEWED FROM "TOP" SIDE OF TORFACE. 
TRIANGULAR MODES ARE GENERATED IN THE 
ORDER INDICATED BY THE CIRCLED NUMBERS. 


N SIDED POLYGON Figure 3-/ (concl) 
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The variables found in the surface data block can be grouped as 

follows: 


- general data 

- dimensional data 

- properties data 
* position data 

- ICS definition data 

A sunmary of the function of each data group follows: 

General d^ta - this "catch all" data group is used to define: 

1) node identification numbers 

2) surface type (disk, sphere, etc.) 

3) active side information 

4) shadowing information, and 

5) nodal breakdown and dimension information. 

Dimensional data - This data group is used to ’efine the desired boundaries 
of the geometric surfaces and portions of same. 

Properties data - This data group is used to define the optical properties 
of the surfaces. Properties allowed are diffuse solar 
absorptivity and transmissivity, diffuse infrared e^issivity 
and transmissivity, specular solar reflectivity, and 
specular infrared reflectivity. 

Position data - These data are the six rotation and translation variables 
• ^'^sary to locate an SCS relative to an ICS, BCS, OR CCS. 
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3. 3. 3. 6 Nodal Surface Identification 


When a surface is subdivided into nodal surfaces, the user has the 
option of numbering the nodal surface consecutively, beginning with the 
identification number he used for the surface, or arbitrarily, using a node 
number array. In either case, he must understand the scheme used by TRASYS to 
identify nodal surfaces. Figure 3-8 illustrates this process with examples of 
surfaces with single and dual active sides. 

The user will no doubt quickly discover from Figure 3-7 that the node 
numbering schemes are related to the SCS-refersnced method but have no 
relation to the CCS-referenced point method. The number scheme functions with 
point input, however, because the first step in processing a point-defined 
surface is to provide it with an internally generated SCS. Once this is done, 
the node numbering scheme can proceed. It is necessary, therefore, for the 
user to understand how the internally generated surface coordinate system 
relates to his point input. This is illustrated for each surface type in 
Figure 3-7. 
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YMIN. Z^aN, RMIN 



YMAX.ZMAX 

RMAX 


XMIN, AXMIN 


XMAX, AXMAX 


YMDl, ZMIN, RMIN 


traz - 4 
NNAX » 3 
SURFN - 1 



YMAX, ZMAX 
RMAX 


XMAX, AXMAX 


XMEJ, AXMIN 


SINGLE ACTIVE 
SIDE. (VIEW FROM 
OUTSIDE OR TOP) 


BOTH SIDES ACTIVE. 

FIRST, THIRD, FIFTH. 

ETC. NODES ARE ON INSIDE 
OR BOTTOM. SECOND , 
FOURTH, SIXTH, ETC. NODES 
are on OUTSIDE OR TOP. 


Figure 3-8 Node Generation Order 
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An understanding of Figures 3-7 and 3-8 should enable the user to properly 
number his nodal surfaces vhen using point input to define the surface. 

The user should realise that the generalized node breakdown schemes 
involving MNX, NNY, UHNX, UNNY, etc., do not pertain to the BOX and POLYGON 
surface types where a fixed node generation scheme exists* If a user desires 
to subdivide the faces of a box, the faces must be input as rectangles. 
Subdividing a polygon requires entering the individual triangles desired. The 
user may wonder at the capricious -looking node breakdown that results from his 
polygon input. This occurs because shadowing solutions exist for triangles, 
but not polygons. After processing, the polygon's triangles are combined for 
output as one node, but the user should be aware of this subdivision process 
in order to avoid duplication of node numbers. 

3.3.3. 7 Dimensional Units 


Nodal areas are carried in data storage for direct irradiation and 
radiation conductor calculations. For this reason, surface data length inputs 
must be in feet, the standard TRASYS length unit. Convenient means of units 
control are provided by D-cards (Ref. 3.3.3.9.1). 

In regard to the surface data block, the user needs to remember that 
all the linear dimensions he uses in defining the surfaces of his model must 
be in feet (after 0-card manipulations) and that all angular measurements 
must be in degrees (and decimal fractions of degrees) of arc. 

3. 3. 3. 8 Properties Data 

In its present state of development, TRASYS is restricted to the 
assumptions that all surfaces are "gray", all surfaces emit diffusely, and all 
surfaces reflect with diffuse and specular components of reflectance. 

That is: 
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“iR* "iR * '’iR * ’"iR ■ *•“ 

where: 


01 » diffuse absorptivity 
p ■ diffuse reflectivity component 

p® » specular reflectivity component 
T » transmissivity 


subscripts : 

IR * infrared waveband 

8 * solar waveband 

It might be observed that since semitransparent materials and 
specular surfaces are allowed, the form factors and direct incident fluxes are 
not, in general, surface property independent but a function of the 
transmissivities and specular components of reflectivity. 

Material transmissivity plays a part in form factor and direct flux 
calculations where blockage by a semitransparent surface is involved. The 
assumption made for these calculations is that any element to element 
conf igur«."ion factor or direct flux with an intervening semitransparent 
surface is multiplied by a shadow factor equal to the value of the blocking 
surface's transmissivity. 

Since only surfaces, rather than bodies, are used in TRASYS 
calculations, only one face of the semitransparent body will "count" as a 
shadower. If two surfaces are input for one body, the square root of the 
transmissivity can be used as the shadow factor to avoid having the shadowed 
configuration factors erroneously multiplied by the square of the 
transmissivity. In this case, the user must enter a negative transmissivity 


Li 
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value. This is detected by the program and the absolute value of the square 
root of the transmissivity used as the shadow factor. Note: if two sides of 

a semitransparent body are generated using ACTIVE ■ BOTH, negative 
transmissivities are not required because only one shadowing surface is 
generated. 

Transmissivity as a function of angle of incidence* can be input as a 
doublet array in the array data block in the form: 

anam- 

Where 6 is the angle of incidence (measured from surface normal) input in 
aonotonically increasing order and T is the transmissivity. 

The applicable array(s) for a given surface is specified by setting IRAKI 
and/or TRANS to the input sequence number of the array. For example, IRANI « 
6.0 indicates that the sixth array in the array data block gives the IR 
transmissivity as a function of angle of incidence for the surface. In the 
case of a surface made up of some type of mesh, the input surface properties 
(ALPH, EMISS, SPRI, and SPRS) should be the actual surface properties of the 
mesh material and not estimated effective properties for the surface. 

Specular reflectivity comes into play in the form factor calculations as a 
result of the imaging techniques used and the definition of an "image factor" 
as described in Appendix I. 

It might be noted that the presence of semitransparent surfaces where 

s s 

T » T and/or the presence of specular surfaces wherep •p results in 
IR s IR s 

different form factor matrices for the infrared and the solar wavebands# Both 

of these matrices are carried in program data storage and are printed in the 

standard output. It should be noted that even when there are no 

semi-transparent surfaces present both form factor matrices are carried in the 

program data storage, however they will be identical. 

♦Not available on Univac version. 
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3. 3. 3. 9 Surface Data Foraac 


3.3.3. 9.1 Control Field Formats 

Eight different types of cards containing control field information 
are allowed in the surface data block. The card types are: 

1. New Surface Card (S Card) 

2. BCS Identifier Card (B Card) 

3. ICS Definition Card (I Card) 

4. Constant Definition Ca. i (R Card) 

5. Linear Dimension Units Card (D Card) 

6. Node identification number increment card (N card) 

7. Reference plane for imaging surfaces and/or BCSs (R Card) 

CRe f . para . 3.3.3.10). 

8. Cosmient Cards 

S Cards are used to signal the completion of the input for a surface 
and the beginning of a new surface. Their general format is: 

CCl CC7 CC7 

3 

S Any surface Data Card ID Information 

Any data encountered beginning with an S ca«*d and ending with the card 
preceding the next S or R card is presumed to apply to a single surface and is 
defined as a surface description. If insufficient data to define a surface is 
found following an S card, either default wi'l be supplied or an error message 
results. If i^^iundant data is entered an error message results. 
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B csrds are used to identify surfaces with the desired block 
coordinate system. Their general format is: 

CCl CC7 CC7 

3 

BCS Block Coordinate System Name Card ID 

All surface descriptions encountered between two B cards will be keyed 
to the BCS name found in the leading B card. Any surfaces not preceded by a B 
card will be automatically keyed to a block coordinate system named ALLBLK. 

BCS ALLBLK defaults to aero rotation and translation parameter values. That 
is» it coincides with the CCS. It may be redefined by the User with 
appropriate data in the Header BCS Data Block. 

See Sections 3.3.3.10.3 and 3.3.3.10.4 for Alternate B Card formats 
for duplicating and imaging Blocks of Surface Data. In addition see Section 
3.3.3.11 if the automatic generation of equivalent form factor for Duplicated 
and/or Imaged BCS feature is desired. 

I Cards are used for definition of intermediate coordinate systems. 
Their general format is: 

CCl CC7 CC7 

3 

I Intermediate Coordinate System Data Card ID 

Continuation cards are allowed for ICS definition. In other words, 
all information encountered between an I card and another card containing 
information in CCl (except for conmtent cards) is presumed to pertain to a 
single ICS. 

NOTE: A general surface data deck structure rule is that all I cards must 

precede all S cards. 
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K cards are used for definition of user constants referred to in 
surface data. Their general format is: 

CCl CC7 CC7 

3 

7 Constants Data Card ID 

Continuation cards are allowed for constants definition. All cards 
between a K card and the next card with data in CCl (excepting conaent cards) 
can be thought of as a data subblock that defines surface data constants. 

note : A general surface data deck structure rule is that all K cards must 

precede all S cards . 

It should be noted that a basic difference exists between 1C*card 
constants and constants entered in the quantities data block. Unlike 
quantities data constants, R*card constants are used for surface data 
manipulation only, and are not available during processor execution. 

D-cards are used for linear dimension units control. Since TRASYS 
computations cannot be made independent of dimensional units, it was necessary 
to choose a standard units system for compatibility betwen the various 
compucation segments and subroutines. The TRASYS standard length unit is 
feet, which is offentimes inconvenient when the user is working from 
engineering drawings in inches, or perhaps a metric unit. This problem has 
been eliminated by all wing for dimension change (D-cards) in the surface data 
input. These cards function as follows: when a D-card is encountered in the 

surface data, all linear dimensions in the surface (S-card) data following 
will be multiplied by the floating point data value on the D^card. This holds 
true until another D^card is encountered or until the end of the surface data 
block. All intermediate coordinate systems referenced by surfaces being 
modified by a D-card are also modified by the D-card. This means that the 
following rule must be observed carefully: The linear dimensions on any ICS 

referenced to in a surface description must agree with the linear dimension of 
the pertinent surface data, prior to modification by a D-card. 
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This D-Csrd formst is: 

CCl CC7 

D DV (floating point) 

A surfses data block using D-cards is shown in Figure 3-9* 

N**cards are used for node number redefinition. The thermal analysis 
of large vehicles frequently involves combining several TRASYS models into 
one. The component models will generally have been generated independently, 
perhaps by different contractors, and node/surface number duplication in the 
various surface data blocks will be cooson. The laborious task of renumbering 
nodes to eliminate duplication is alleviated considerably by use of the N-card 
option. When an M-card is encountered in the surface data, all node and 
surface numbers in the surface (S-card) data following will be changed 
accordingly to: 

SORFN - SURFN NINC 


where: 


MINC is an integer value found on the N-card. 

This holds true until another N-card is encountered or until the end of the 
surface data block. Changing SURFN for a surface means that all iwde numbers 
associated with that surface are changed, whether automatically generated or 
input as an integer array. 
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HEADER OPTION DATA 
TITLE CLASSES FOLLY 
MODEL-CLAS 

HEADER SURFACE DATA 

D 1./12. $ FOLLOWING LINEAR DIIENSIONS ARE MULTIPLIED BY 1./12. 

S SURFN-201, 

TYPE-CYL, 

R-1.0,ZMIN-3.0,ZMAX-15.0,AXMIN-0.0,AXMAX«360.0,NNZ-1 ,NMAX-1 , 
ACTIVE-OUT, ALPHA-0.3,EMISS-0.9, 

TY-5.0, 

S SURFN-301 

TYPE-SPHER 

R-3.0,ZMIN-0.0,ZMAX-3.0,AXMIN-0.0,AXMAX-180.0,NNZ-1 ,NMAX-1 , 
TZ-20., 

ACTIVE-OUT ,ALPHA-0 . 2 , EMISS-O . 9 , 

S SURFN-401, 

TYPE-COME 

R- 1 . 0 , ZMIN-0 . 0 , ZMAX-2 . 0 , AXMIM-0 . 0 , AXMAX-360 . . ' , NN :-l , NNAX-1 , 
TZ-17.0,ROTY-180., 

TY-5.0, 

ACTIVE-OUT, ALPHA-0 . 9 , EMISS-O . 9 , 

S SURFN-501 

TYPE-CONE, 

R-3 . 0 , ZMIM-1 . 0 , ZMAX-3 . 0 , AXMIN-O . 0 , AXMAX-1 80 . 0 ,NNZ-1 , MNAX-1 , 
TZ-2.0, 

ACTIVE-OUT, ALPHA-0. 9, EMISS-O. 9, 

D 1. $ TERMINATES EFFECT OF PREVIOUS D-CARD 

N 10 $ REMAINING NODE NUMBERS ARE INCREASED BY 10 

S SURFN-701 

TYPE-CONE 

R- 1 . 0 , ZMIN-1 . 0 , ZMAX-2 . 0 , AXMIN-O . 0 ,AXMAX-360 . 0 ,NNZ-1 , NNAX-1 , 
TZ-1.0, TY-5.0, 

ACT I VE-OUT , ALPHA-0 . 9 , EMISS-O . 9 , 

S SURFACE- 901 

TYPE-TRAP 

Pl-0. 707*4.0,0. 707*5.0,4.0, 

P2-0. 707*3.0, 0.707*3.0, 5.0, 

P3-0. 707*3.0,0. 707*3.0,8.0, 

P4-0 . 707*5 .0,0. 707*5 .0,6.0, 

ACT I VE-B JTH , ALPHA-0 . 2 , EMISS-O . 9 , 

S SURFN -905, TYPE-POLY 

PI— .707*5.,. 707*5., 4. 

P2-. 707*3. ,.707*3. ,5. 

P3-0. 707*3.0, . 707*3.0,8.0 
P4-0. 707*5.,. 707*5., 6. 

ACTIVE-BOTH,PROP-.2,.9 ' 

HEADER OPERATIONS DATA 
BUILD CLAS,ALLBLR 
L NPLOT 

END OF DATA 

FIGURE 3-9 D-Card and N-Card OperaCions Example 
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The following H*card restriction siust be observed: the variable NINC 

BUiy take on any positive or negative integer value such that 

1 ^ SURFN * NINC £ 99999 
is true for all values of SURFN involved. 

The N-card foinsat is: 

CCl CC7 to CC 72 

N NINC 

A surface data block using N-cards is shown in Figure 3'*9. 

Coonent cards, with the following format: 

CCl CC7 CC7 

3 

C Comaent Information Card ID 

may appear in any data block. Another means of entering coosent information 
is to delimit a data field (CC7-72) with a $ and enter cosnent information to 
the right of it, as follows: 

CC7 CC7 

3 

Surface Data $ Coonent Data Card ID 

This may tempt the user to place a $ in the data field of an otherwise blank 
card and enter a coonent. This is illegal. It results in a blank data field 
and an error message. Also, this option is not available in the Operations 
Data and Subroutine data blocks. 
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3<3.3.9.2 Single Variabla Input Poraat 

Any tingle verieble t.ecogniced at turfaee data may be entered in a 
card data field according to the general format: 

0C7 CC7 

2 

NAMEl - DV, NAME2 - DV, 

NAMEl and NAME2 may be any variable name defiiMd by the turfaee data variablet 
litt (Table 3-1), plut in the cate of R cardt, the namet may be at defined by 
the uter, limited only by the mode and word length limit of 6 charactert. 

t 

Single variable input it the only means available for defining the 
following list of surface data variables. 


TYPE 


NNX 

SURFN 

ACTIVE 

NOTE 1 

NNY 

IREFSF 

SHADE 


NNAX 

IDUPSF 

BSHAOE 


ICSN (in « surface 

IMACSF 

SPRI 

NOTE 2 

description) 

REFNO 


SPRS 

Notes: 1. If ACTIVE - BOTH and SHADE • NO, the SHADE Flag applies only to 

t*;e "bottom'* or "inner" surface. SHADE ^ NO automatically f 
the "top" or "outer" surface. 

2. If either RBCAL or DRCAL are to be used in Operation Data, the 
following restrictions must be osberved. (Note: These 

restrictions do not apply to the use of RTCAL.) 

NNX ■ NNY « 1 (one node allowed per specular surface) 

TYPE • RECT, DISC, TRAP, B0X5, B0X6, or POLY (specular surfaces 
must be planar) 
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SHADE ■ FF or BOTH (epecular •urfeces suet be ehedovere in FF 
•epnenc. This fleg is reset by the progrsa to "FF" if 
unspecified or specified es "NO" end is reset to "BOTH" if 
specified es "DI.") 

All other surfsce date vsriebles My be defined in convenient "short fora" 
array foraats per subsections 3. 3*3. 9. 3 through 3.3.3.9.9> 

3. 3. 3. 9. 3 Interaediete Coordinate Systea Data Fonsat 

ICS data My be entered in array foraat as follows: 

CCl CC7 CC7 

2 

I ICSN, TX, TY, TZ, RDTX, ROTY, ROTZ 

This array defines th* translations and rotations necessary to transfora a BCS 
(or CCS) into the ICS. The new user should refer to para. 3.3.3.9.11 until 
defining this trsns foraat ion becoMs autoMtic. The three rotations, ROTX, 
ROTY, and ROTZ ere performed in that order. If it is desired to alter the 
order of the rotations, the following hybrid foraat is used: 

CCl CC7 

I ICSN, TX, TY, TZ, ROTY - DV, 

ROTZ • DV, ROTX - DV 

for rotation first about the BCS Y-axis, second about the BCS !7-axis and third 
about the BCS X-axis. 

It should be noted that each ICSN value appears at least twice in Che 
surface data block. Once in the I card defining Che ICS, and again in each 
surface description where an SCS/ICS Cransfera is desired. 


CC7 

2 
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3 . 3 . 3 . 9 .4 Surface Identification Format 


A single node surface is identified as follows » in single variable 
input format: 


CCl 


CC7 


CC7 

2 


S SURFN • DV (Integer) 

If a surface is to be subdivided into several nodes, and they are not to be 
numbered consecutively, the node number array may be entered according to the 
formats : 


CCl 

S 


CC7 

SURFN - DVl, DV2, ^DVN 


CC7 

2 


or for consecutively nuisbered nodes 

CCl CC7 

S SURFN ■ DVl 

which generates node numbers DVl, DVl 1, 
DVl + 2, DVl ♦ (N-1) 

for an N-node surface. 
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3. 3. 3. 9. 5 Properti«> Daf Format 

The diffuse properties date My be defimd using the following forMt 

CC7 CC7 

2 

PROP - ALPHA, EMISS, TRANS, TRANI 

If values for TRANI and TRANS are not encountered, they will default to sero. 

Specular properties data must be input in the single variable format 
(see 3. 3. 3.9. 2). 


3. 3. 3. 9.6 Dimensions Data Format 


The dimensions data My be defined using the following format: 


CC7 

DIMEN - R, ZMIN, ZMAX, AXMIN, AXMAX 


CC7 

2 


3. 3. 3. 9. 7 Point Data Format 


The X, y, z coordinates of point data input are defined using the 
following format: 


CC7 

PN - XN, YN, ZN 


CC7 

2 


3-68 


Revision 3 


N value* up to 19 are recognised, depending on Che surface type (Ref. Figure 
3-7). 


This is Che only format allowed for point data. Single variable 
definitions are not allowed. 

3.3.3 9.8 Position Data Format 


The position data may be defined using Che following format: 

CC7 CC7 

2 

POSIT - TX, TY, TZ, ROTX, ROTY, ROTZ 

This array defines the translations and rotations necessary to transform an 
ICS, BCS, or CCS into the SCS. The new user should refer to para. 3.3.3.9.11 
until defining this transformation becomes automatic. The three rotations 
ROTX, ROTY. and ROTZ are performed in that order. If it is desired to alter 
Che order of the rotations, the following format is used: 

CC7 CC7 

2 

POSIT - TX, TY, TZ, ROTY « DV, ROTZ - DV, ROTX « DV 


The Position Data is only applicable Co Che "SCS method" of surface 
definition and not the point raeChcd. 


3. 3. 3. 9. 9 Comment ^ ita Format'. 


A Hollerith string of up Co thirty characters may be entered with each 
surface description according to the following format: 


CC7 

COM • * Any Alphameric Data * 


CC7 

2 
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These cosnents will be passed to the processor and printed with the 
surface description output that results from the BUILDC and ADD calls in the 
operations data. 

3.3.3.9.10 Node Boundary Dimensions 

When it is desired to generate an unequal node breakdown on a surface, 
it is necessary to define the node boundaries using one or wore of the UNNX, 
UNNY, UNNZ, UNNAX, UNNTH, and UNNR arrays. Figure 3-10 illustrates this 
scheme for UNNZ and UNNAX. 
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Figure 3-10 Exasple of Unequal Node Boundaries 


This example required the following unequal boundary arrays: 


UNNAX - DVIAX, DV2AX 
UNN2 » DV12 
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These errsys ere entered in the surface date block according to the following 
format: 


CC7 CC7 

2 

UNHAX - DVIAX, DV2AX 
uh:;! - DViz 


The general format is: 


CC7 

UNNX « DVl, DV2, . . . DVN 


CC7 

2 


where: N • NNX -1 
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3.3.3.9.11 Coordinate Systen Definition Proceee 


The definition of any coordinate ayatem relative to another requires 
the user to input the variables TX, TY, TZ, ROTX, ROTY, and ROTZ. Assutsing 
that it is desired to define an SCS in the CCS, BCS, or ICS, the required 
variables can be evaluated by the following procedure: 


1. Mentally locate the SCS origin in CCS, BCS or ICS 3-space. 

2. The X, Y and Z coordinates, in CCS, BCS or ICS 3-space, of the SCS 

origin are TX, TY and TZ respectively. 

3. Mentally locate the CCS, BCS or ICS origin at the SCS origin, with 

the CCS, BCS or ICS axes parallel to their actual directions. 

4. Define up to three rotation angles ROTX, ROTY and ROTZ which can be 
performed in any order that will finish with the CCS, BCS, or ICS 
located per 3., coincident with the SCS. 

Enter the TX, TY, TZ, ROTX, ROTY and ROTZ valves on the B-card in 
the HEADER BCS Di>TA block (to define the BCS relative to the CCS), 
and in the HEADER SURFACE DATA block on the I-card (to define the 
ICS relative to a BCS or the CCS), or in position data (to define 
the SCS relative to an ICS, a BCS, or the CCS), maintaining the 
order in which the rotations were performed. 

3.3.3.10 PUP and IMAGE Options 


Two options are available that enable the user to conveniently 
duplicate surfaces already defined in Che surface data blocks or otherwise 
redefine them and add them to configuration or configurations in the surface 


L- 


( 
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data. Using the surface DUP option, single surfaces, consisting of one or 
more nodes can be created by referencing previously input surfaces. Using the 
BCS OUP option, entire blocks of surfaces previously defined under a 
particular BCS namm can be created by simply referencing a previously input 
BCS name. 


Similarly, images of single surfaces and blocks of surfaces can be 
created using the surface IMAGE option and the BCS IMAGE option. These 
options greatly reduce the user’s effort if he is defining a bi-laterally 
syosetric configuration. 

The BCS DUP and BCS IMAGE options are highly recomsended whenever 
symmetry exists because the preprocessor logic that generates the syosetric 
surface descriptions also recognises the equivalent form factors that exist 
due to symmetry. Equivalent form factor data is generated internally and 
passed on to the processor, thus eliminating redundant form factor 
calculations. Refer to para. 3. 3. 5. 4 for guidance in using this feature. 

3.3.3.10.1 Surface DUP Option 

The following rules and restrictions apply when using the surface DUP 

option: 

a) Surfaces to be duplicated must appear in the surface data block before the 
surfaces that are to be created by duping. 

b) Any or all of the surface description variables of the surface being 
duplicated can be changed. 
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c) If the turfecc to be duplicated waa input by the point method and any 
changea are to be made in the poipta» all points must be input for the 
surface being created. 

d) Generated surfaces such as boxes and polygons will be duped in their 
entirety. That is, the iidividual nodes generated by "box" or "polygon" 
cannot be duped. 

e) Surfaces created by the DDF option may later be imaged. 

f) The surface to be duplicated is specified by setting the variable IDUPSF 
equal to the surface number. 

g) Any correspondence data that applied to the nodes created by the Surface 
DUP option must be supplied by the user in the Correspondence data block. 

A sample input deck using the surface DUP option can be found in Figure 

3-11. 


3.3.3.10.2 Surface IMAGE Option 

The IMAGE option allows the user to create surfaces by Imaging 
previously input surfaces in some specified reference plane. The following 
restrictions and rules apply when using the IMAGE option: 

a) Surfaces to be imaged must appear in the surface data block before the 
surfaces that are to be created by imaging. 
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b) Reference plenes (imaging planea) in which surfacee are to be imaged are 
special surfaces designated by R-cards. Bach of these planes is assigned 
a unique identification number and is defined by specifying, in any 
order, any three non-colinear points lying on its surface. These points 
are defined with respect to the CCS. 

c) Generated surfaces such as boxes and polygons will be imaged in their 
entirety. That is, individual nodes generated by "box" or polygon" 
cannot be imaged. 

d) Surfaces created by imaging cannot be duped. 

e) For purposes of imaging, the image surface, the reflecting plane, ^nd the 
imaged surface are treated internally to the program as if they were 
defined with respect to the central coordinate system 
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HEADER OPTIONS 

DATA 

TITLE DUP OPTION SAMPLE PROBUM 

READER SURFACE 

DATA 

S SURFN 

-10 

TYPE 

-SPHERE 

R 

-10 

ZMIN 

—9.99 

ZMAX 

-9.99 

AXMIN 

-0. 

AXMAX 

-360. 

TX 

-0. 

TY 

-10. 

TZ 

-20. 

ACTIVE 

-OUT 

PROP 

-0.2, 0.9 

COM 

-* SURFACE TO BE 

S SURFN 

-20 

IDUPSF 

-10 

R 

-20. 

ZMIN 

—19.99 

ZMAX 

- 19.99 

TZ 

—20. 

PROP 

-0.5,0. 8 

COM 

-* DUPLICATE OF 1 


HEADER OPERATIONS DATA 
SniLD FIC2, ALLBIiC 
L NPLOT 
END OF DATA 


Figure 3-11 Ssaple Problea Using the Surface DUP Option 
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f) The iurfacc to be iaaged is epecified by setting the varisblc IMACSF equal 
to the iaaged surface nuaber. The reference plane in which IMAGSF is to 
be iaaged la specified by setting IREFSF equal to the reference plane 
nuaber. 

g) When a surface is iaaged* the nodes are also iaaged resulting in a 
reversed order of node nuabering. The active side of the surface also 
follows iaage rules. Figure 3-12 illustrates these phenosMna. 

h) Any correspondence data that applies to the nodes created by the surface 
IMAGE option sMSt be supplied by the user in the correspondence data block 

A saaple problea illustrating the surface IMAGE option can be found in 
Figure 3-13. 

3.3.3.10.3 BCS PUP Option 

The following rules and restrictions apply when using the BCS IMJP option. 

a) All the surfaces comprising the BCS to be duplicated aust appear prior to 
the BCS that exercises the BCS DUP option. 

b) All diaensional properties* surface properties and shadowing 
characteristics of each surface in the BCS generated by Che BCS DUP option 
remain exactly the sasw as those in the BCS that was "DUPED". The new 
surfaces can »e aoved as a group by the paraaeters defining the new BCS in 
Che BCS data ..lock. The remaining properties nay be altered in the 
operations data block by use of the "MOD" series of subroutine calls. 
(Reference Section 4.3.8). 


Kcvision j 


c) Block* of aurfac** crtattd by the BCS DUP option My b« again DUPED by 
another BCS DU? operation. 

d) Block* of *urfecea created by the BCS IHACE option (*ee 3.3.3.10.4) cannot 
be DUPED. 

e) Surface* defined in the u*uel manner that follow the BCS card that 
perfona* BCS duping will aimply appear together with the aurface* created 
inder the *eM BCS naM. 

f) BCS* My not be DUPED under the *eae BCS name. 

g) Uaer correapondence data for the aurface* generated under the BCS DUP 
option need not be defined a* auch in the eorreapondeiK* data block. 
Correapondence date applying to node* within a BCS to be "duped" My be 
entered with a BCS naM reference in the correapondence data block. See 
Section 3. 3. 8. 5 for guidance in uaing thia feature. 

NOTE: Correapondence data for polygon* created by BCS DUP ia autonatically 

generated. 

BCS DUP card fomat: 

CCl CC7 

BCS BCSNAM, DUPBCS - INAME, NINC - NNN 
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CCS ORIGIN 




REFERENCE PLANE 50 


Y 



X 


Z 



NOTE: NODE X+IO IS THE IMAGE OF NODE X 


Figure 3-12 


Imaging of Nodes and Active Side (Image Option Sample Problem) 
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HEADER OPTIONS DATA 

TITLE IMAGE OPTION SAMPLE PROBLEM 

HEADER SURFACE DATA 


SURFN 

m 

1 

TYPE 

m 

RECT 

ACTIVE 

.1 

TOP 

NNX 

m 

3 

NNY 

s 

2 

PROP 

m 

0.5, 0.9 

PI 

m 

3.0, 4.0, 1.0 

P2 

m 

1.0, 5.0, 1.0 

P3 

m 

1.0, 6.0, 4.0 

COM 

m 

♦SURFACE TO BE IMAGED* 

SURFN 

a 

11 

IMAGSF 

a 

1 

IREFSF 

m 

50 

ICSN 

a 

100 

COM 

» 

♦IMAGE OF SURFACE 1* 

REFNO 

m 

50 

PI 

m 

0.0, 1.0, 0.0 

P2 

a 

O 

• 

o 

• 

o 

• 

o 

P3 

a 

1.0, 1.0, 1.0 

COM 

m 

♦REFERENCE PLANE* 


HEADER OPERATIONS DATA 
BUILD FICl.ALLBLK 
L NPLOT 

END OF DATA 

Figure 3-13 Sample Problem Using Che Surface Image Option 
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where: 


BCSNAM 


Naae of block coordinate syateoi under which 
OUP-generaced surfaces are placed. 


INAME 


Name of block coordinate system under which surfaces to 
be "DUPED" are defined. 


DUPBCS 


Required control word. 


NINC 


Node number increment applied to all nodes under BCS 
INAHE to generate the node numbers under BCS BCSNAM. 
(Integer Number) 


A sample input deck using the BCS DUP option can be found in Figure 


3-14. 


3.3.3.10.4 BCS IMAGE Option 

The following rules and restrictions apply when using the BCS IMAGE 

option. 

a) All the surfaces comprising the BCS to be imaged must appear prior to 
the BCS that exercised the BCS image option. 

b) All surface properties and shadowing characteristics of each surface in 
the BCS generated by the BCS IMAGE option remains the same as Chose of 
the surfaces that were imaged. All dimensional properties appear as 
mirror images of Che original surfaces, as seen in the "reflecting" 
plane. The surface properties and shadowing characteristics may be 
altered using Che MOD subroutines in Che operations data block. 
(Reference Section 4.3.8) 
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c) Blocks of surfaces crested by the BCS IMAGE option may be again IMAGED by 
another BCS IMAGE operation, but they sMy not be DUPED. 

d) Surfaces defined in the usual manner that follow the BCS card that 
performs BCS isiaging will simply appear together with the surfaces created 
under the same BCS naise. 

e) Automatic generation of correspondence data applies to both the BCS DUP & 
BCS IMAGE features. Refer to para. 3. 3. 8. 5 under correspondence data for 
guidance. 

BCS cards that exercise the BCS IMAGE option have the following format 
and variable definitions: 


CCl CC7 

BCS BCSNAM,IMGBCS - INANE, MINC>NMN,IREFSF>NNN 

BCSNAME, INAME and NIMC ace defined the same as on BCS cards that exercise 
duping. Imaged surfaces may become part of a previously defined BCS system 
(INAME) by making BCSNAM identical to INAME. IREFSF is the number oc the 
reflecting plane surface. (Integer 1-99999) IM6BCS is a required control word. 


3-83 


Revision 3 


HEADER OPTIONS DATA 
TITLE GOBt.ES FIRST PCX.LY 
MODEL-FIGl 
HEADER SURFACE DATA 
BCS RIGHT 
S SURFM *201, 

TYPE-CYL, 

R- 1 . 0 . ZMI N>3 . 0 . ZMAX*1 5 . 0 , AXMI N-0 . 0 , AXMAX-360. 0 , NNZ- 1 , NNAX- 1 , 
ACTIVE-OUT, ALPHA-0. 3, EMISS-0. 9, 

TY-5.0 

S SURFN-301 
TYPE-SPHER 

R-3 . 0 , AMI N-0 . 0 , 2MAX-3 . 0 , AXMl N-0 . 0 , AXMAX-1 80. 0 , NNZ- I , NNAX- I , 
TZ-20. , 

ACTIVE-OUT, ALPHA-0. 2 .EMISS-O. 9, 

S SURFN-401, 

TYPE-CONE 

R- 1 . 0 , AMI N-0 . 0 , ZHAX-2 . 0 , AXMI N-O . 0 , AXMAX-360 . 0 , NNZ- 1 , NNAX- I , 
T2-17.0,R0TY-180. , 

TY-5.0, 

ACTIVE-OUT, ALPHA-0. 9 , EMISS-O . 9 , 

S SURFN-501 
TYPE-CONE, 

R-3 . 0 , AMI N»1 . 0 , ZMAX-3 . 0 , AXMIN-0 . 0 , AXMAX-1 80. 0 , NNZ- 1 , NNAX- 1 , 
TZ-2.0, 

ACTIVE-OUT, ALPHA-0 . 9 , EMI SS-0 . 9 , 

BCS LEFT,DUPBCS-RIGHT,NINC»500 

C ABOVE CARD GENERATES SURFACES 701,801,901, AND 1001. 

C BY DUPLICATION OF SURFACES UNDER BCS RIGHT. 

C 

HEADER BCS DATA 

BCS RIGHT.O. ,0. ,0. ,0.,0. ,0. 

BCS LEFT,0.,0. ,0.,0.,0.,0. 

HEADER OPERATIONS DATA 

CALL CHGBLK(LEFT,0. ,0. ,0. ,0, 0,0,0. ,0. ,180. ) 

BUILD FI G1 , RIGHT , LEFT 

L NPLOT 
END OF DATA 


Figure 3-14 BCS Duping Operations Example 
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HEADER OPTION DATA 
TITLE GOBLES SECOND FOLLY 
MODEL FIGl 
HEADER SURFACE DATA 
BCS RIGHT 

S SURFN-201, 

TYPE-CYL, 

R- 1 . 0 . ZMI N-3 . 0 , ZNAX-1 5 . 0 , AXMI N-O . 9 , AXMAX-360 . 0 , MNZ- 1 , NNAX- 1 , 
ACTIVE-OUT,ALPHA-0.3,EMISS-0. 9, 

TY-5.0 

S SURFN-301 

TYPE-SPHER 

R-3. 0, ZMIN»0. 0. ZMAX-3. 0, AXMIN-0. 0. AXMAX-180. 0, NNZ-I , NNAX-1 , 
T2-20. , 

ACTIVE«OUT, ALPHA-0 . 2 , EMISS-0 . 9 , 

S SURFN-401, 

TYPE-CONE 

R-1. 0, ZMIN-0.0, ZMAX-2.0, AXMIN-0. 0,AXMAX-360.0, NNZ-1 , NNAX-1 , 
TX-17.0,R0TY-180. , 

TY-5.0, 

ACTI VE-CUT , ALPHA-0 . 9 , EMI S S-0 . 9 , 

S SURFN-501 

TYPE -CONE 

R- 3 . 0 , ZMI N-1 . 0 , ZMAX-3 . 0 , AXMI N-0 . 0 , AXMAX- 1 80. 0 , NNZ- 1 , NNAX- 1 , 
TZ-2.0, 

active-out , ALPHA-0 . 9 , EMISS-0 . 9 . 

BCS LEFT, IMGBCS-RIGHT.NINC-500, IREFSF-999 

C ABOVE CARD GENERATES SURFACES 701,801,901, AMD 1001. 

C THEY ARE IMAGES OF 201,301,401, AND 501 AS SEEN 

C IN REFLECTING SURFACE 999. 

C 

R REFNO-999 

PI —0. ,0. ,0. 

P2 -1.0,0. ,0. 

P3 -0. ,0. ,1.0 
HEADER BCS DATA 

BCS .■aGHT,0. ,0. ,0. ,0. ,0. ,0. 

BCS LEFT, 0. ,0. ,0. ,0. ,0. ,0. 

HEADER OPERATIONS DATA 
BUILD FIGl, RIGHT, LEFT 
L NPLOT 

END OF DATA 


Figure 3-15 BCS Imaging Operations Example. 
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A sample input deck using the BCS IMAGE option can be found in Figure 
3~1S. Careful examination of Figures 3-14 and 3-15 will show that they define 
the same configuration in a different manner. 

3.3.3.11 Automatic Generation of Equivalent Form Factors 

vnien the BCS dup or BCS image feature is used in surface data input, a 
symmetry situation is usually created, wherein a good many form factors are 
equivalent to each other. This is illustrated as follows: In Figure 3-I6a, 

nodes 11, 12, 13, and 14 in BCS2 were created by duplication of nodes 1, 2, 3, 
and 4 in BCS 1 plus offsetting BCS2 and BCSl by BCS data block or CHGBLK 
input. In this situation, Fll-12 ■ Fl-2, Fll-13 ■ Fl-3, and so on. The 
tedious task of writing the necessary fonn factor equivalence data has been 
taken over by software within TRASYS. This feature is implemented by an 
adaitional paraaieter on the BCS dup card. For the situation in Figure 3-16a, 
the card: 

CCl CC7 

BCS BCS2, DUPBCS - BCSl, NINC ■ 10, IGEN - PART 

will create nodes 11 thru 14 and also the equivalent form factor data needed 
to avoid calculating all of the ^orm factors between nodes 11, 12, 13, and 
14. Note that the form factors between 1 thru 4 and 11 thru 14 (e.g., Fl-12, 
FI 1-2, etc.) must still be calculated because there is no predictable symmetry 
involved. 

There are situations where this auto-generation of equivalent form 
factors is not appropriate. In figure 3-16b, the necessary syamietry is not 
present due to intervening surfaces. In this case, the card: 

CCl CC7 

BCS BCS2, DUPBCS - BCSl, NINC ■ 10 
is used to prevent auto-generation of equivalent form factors. 
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Figure 3-16. Equivalenc Form Factors 

When the BCS image feature is used, the symmetry shown in figures 
3-16a and 3-16b exists. In addition, a second type of symmetry may exist 
because of the image relationship between the two groups of nodes. In figure 
3-17a, the same equivalent form factors as in 3-16a exist. In addition, note 
that Fl-12 ■ Fll-2, Fl-13 ■ Fll-3, and so on for the form factors "looking" 
across the reflecting plane. In this case, the appropriate BCS card is: 

CCl CC7 

BCS BCSl, IMCBCS ■ BCSl, NINC - 10, IGEN » ALL 

Note that the image of BCSl is placed in BCSl. This is the only way that the 
"ALL" equivalence situation can be guaranteed, so if BCS2 ■ BCSl and IGEN ■ 
ALL, the program will nevertheless set IGEN ■ PART. 
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When surfaces intervene betmen the two iisaged groups, the second type 
of synnetry is not present (figure 3-17b) and the appropriate card is: 


CCl CC7 

BCS BCS2.INGBCS - BCSl.NINC - 10, IGEN - PART 

If BCSl and BCS2 are not defined identically in the BCS data block, or 
one is moved relative to the other by a CHGBLK call, the second type of 
synnetry again does not exist (figure 3-17c) end the card appropriate for 
figure 3*1 7b should be used. 


Intervening surfaces located within one or the other set of nodes 
destroys all synnetry (figure 3*17d) and the following card must be used: 

CCl CC7 

BCS BCS2, IMGBCS • BCSl, NINC • 10 


Please note that if the IGEN variable does not appear on the BCS card, no 
equivalent form factor generation will be done; thus, the program is still 
compatible with input decks created before this feature was incorporated. 
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3.3.3.12 Shsdower-Only Surfscea 

In many radiation^dominated eharmal analysis problems , there are 
surfaces which arc so remote from Che region of interest that they do not 
actively enter into the radiation nettiork. These surfaces, however, block 
incoming radiation and the view Co space for Che nodes of interest. The use 
of shadower-only surfaces permits Che user to account for this blockage 
without increasing Che complexity of his problem in Che region of interest. 

The following rules apply in the use of shadower>only surfaces: 

a) Shadower*-only surfaces provide blockage in both the FF and Che DI 
segments. 

b) Form factors from node i to both sides of shadower-only surfaces 

are summed and added to F. . to conserve energy (Infers T . , 

It shadowers 

• Tj^). 

Flag IFFSHO can be set equal Co 2HN0 in Che Quantities Data Block 
or in Che Operations Data Block to bypass Che calculation of form 
factors CO shadower-only surfaces. IFFSHO defaults to 3HYES. 

c) Because these surfaces are not active in Che problem, neither the 
active side nor Che surface optical properties need be input. 

d) Shadower-only surfaces are specified by setting the shade flag; 
SHADE • ONLY. 

e) Shadower-only surfaces must be added after all active surfaces. 

It is recomnended that shadower-only surfaces be input in separate 
BCS(s). These BCS(s) must be added last in the BUILD-ADD 
sequence. (Reference Appendix D, Pg D-2, D-7.) 

f) Shadower-only surfaces may appear or not appear in node plots, at 
Che User's option. This is controlled by the ISHO argument in 
subroutine NDATA (reference Appendix D). 
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3.3.4 BCSData 

3.3.5 Form Factor Data 
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3.3.4 BCS Data 


Each block coordinate aystas named in the aurfaea data block muat be 
defined in the BCS data block. An exception ia the default BCS "ALLBUC" where 
all aurfacaa in the Surface Data block that art not pracaadad by a "B" CAIU) 
(aaa para. 3. 3. 3. 9.1) are aaaumad to be a part of BCS "ALLBLK". BCS "ALLBLK" 
ia aaaumad alwaya to be coincident with the CCS. If all aurfacaa defined in 
the aurfaea data block are in BCS **ALLBLK'' and the aaaumad coincidence with 
the BCS ayatam ia acceptable than No Header BCS Data block ia required. If 
the uaar wiahaa to chang-^ the poaition and/or orientation of BCS "ALLBLK" it 
can be accompliahad aa i^ it waa a BCS named by the uaar. Block coordinate 
ayatema are defined according to the following fonaata: 


CCl CC7 

B BCSNAM, TX, TY, TZ, ROTX, ROTY, ROTZ 


CC7 

2 


If the rotationa are not to be performed in the atandard x, y, s, order, the 
hybrid format: 

CCl CC7 CC7 

2 

B BCSNAM, TX, TY, TZ, ROTZ - DV, 

ROIX ■ DV, ROTY, ■ DV 


may be uaed. Rotationa in thia example are performed firat about Z, then Y, 
then Y. Arithmetic expreaaions can be uaed for data values (reference Section 
2.3). 


a - • 


7'. 07. I WOT rlLMED 


r; i" /cix wot fJLiWEo 
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Th« variable natMa ancarad in cha BC8 data block ara defined in Talla 
3-IV. Mote chac Chaaa dafinitiona ara alaoat idancical to the ICS and 
poaition data of the aurfaca data block, «van to variable naaaa. Thia eraataa 
no aabiguity, bacauaa the poaition and ICS variablaa ara >jaad in the 
praprocataor only, and unlike the BCS variablaa, ara not addraaaabla froai the 
procaaior routines. In eoaa»n with position and ICS data, theaa tranalatio'S 
and rotation variablaa appear to translate the CCS into the BCS. The new user 
should refer to para. 3.3.3.9.11 until defining thia tranofomation becoaea 
autoaat ic . 


VARIABLE 

HAME 

RANGE OR 
OPTIONS 

DEFAULT 

VALUE 

DESCRIPTION 

BCSN 


ANY 6 

CHARACTER 

NANS 

NONE 

BLOCK COORDINATE SYSTEM NAME 

TX 


N/A 

0.0 

TRANSLATION DISTANCE FROM ORIGIN OF CCS TO 
ORIGIN OF BCS, MEASURED ALONG CCS X-AXIS. 

TY 


N/A 

0.0 

SAME AS TX, EXCEPT ALONG Y-AXIS 

TZ 


N/A 

0.0 

SAME AS TX, EXCEPT <\L0NG ^-4^XIS 

ROTX 

-36C. 

ROTX 360. 

0.0 

ROTATION ANCLE TO ROTATE CCS INTO BCS; 
ROTATES ABOUT CCS X-AXIS, Y TOWARD Z 
POSITIVE. 

ROTY 

-360. 

ROfY 36C. 

0.0 

SAME AS ROTX, EXCEPT ROTATES ABOOT Y, Z 
TOWARD X IS POSITIVE. 

ROTZ 

-360 

ROTZ 360. 

0.0 

SAME AS ROTX, EXCEPT ROTATE.S ABOUT Z, X 


TOWARD Y IS POSITIVE. 
Table 3-IV BCS Data Input Detail 
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3,3,5 Form Factor Data 


The Fom Factor Data block provldaa a punchad card and/or CMERC tapa 
(•aa Saction 3*2. 2. 3) BCD fomattad antry point, ao that tha uaar can control 
tha fora factor data coapucationa parfotaad whan aithar tha FFCAL or IfFCCAL 
llnka ara callad in tha Oparationa Data Block. 

A Fora Factor Data block ia required whan: 

1. With or without an RSI tapa tha uaar wanta to by-yaaa the 
coaputationa of aoaa fora factor * area (FA) producta (or data which 
ia atorad on tha RSI tapa), and inataad utiliaa hand input data 
valuaa, or aalactad valuaa on a CHERC tapa froa a pravioua run that 
the uaar haa datanainad to be applicable. 

2. The user wanta to override aoaa of tha data valuaa on the RSI tape 
and have the prograa recoapute new valuaa, perhaps because of a need 
to specify a tighter fora factor accuracy criteria in subroutines 
FFDATA or NFDATA. 

A Fora Factor Data Block is not required for noraal restart operations 
when all the fora factor area (FA) producta already stored on the RSI tape are 
applicable to the configuration being run. 

The user aay override the check the prograa noiaally aakes to see if 
the active node array aatches the node array for the FA aatrix stored on the 
RSI tape. This is aceoaplished with the arguaant FFNAC in subroutines FFDATA 
or NFDATA. Overriding this check in the prograa will allow the user to: 

1. Reaove nodes /surface a anywhere by changing the Surface Data block 
and/or Operations Data block. The prograa will delete the directly 
related FA data and will arrive at utilising a reduced FA aatrix. 

This reduction aay be done with or without a Fora Factor Data block. 

If in the surfaces reanved there are surfaces which had affected the 
remaining stored values, i.e. blockers, then it is up to the user to 
utilize a Fora Factor Data block to selectively set or recoapute those 
data values significantly iaq>acted by the model change. 
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2. Add nodet/eurfaces with unique identification numbers by changing 
the Surface Data block and/or Operations Data block. This can be done 
with or without a Form Factor Data block. Without a Form Factor Data 
block the program will utilize all the values previously cosq>uted and 
stored on the RSI tape, and will set up a request matrix to compute 
the remaining FA data values. As was the case with deletions it is 
left up to the user to decide if a form factor dat« block is required 
to correct or recompute some of the data values read in the RSI 

tape. 

The node number check is automatically disabled when merging the form 
factors on two restart tapes into one using subroutine RSMERG. 

A caution must be observed when attempting to recover FA data on a 
restart tape when the total number of nodes is being reduced. This is 
illustrated by the following example. The original run computed form factors 
for a 300 node model, including a large cylinder subdivided into nodes. In 
the run now being prepared, 20 new nodes are being added, but the detail in 
the area of the cylinder is not required and the surface data defining the 
cylinder will be edited to reduce its ntunber of nodes to one. Thus, the new 
configuration being defined will consist of 273 nodes. This is an acceptable 
procedure. The problem that crops up is that the maxisnim possible number of 
active nodes, as determined by analysis of the surface data block is 273 and 
the node data storage arrays will be sized accordingly. When the FA products 
from the 300 node model are read from the RSI tape, there will be insufficient 
core to receive them and the run will terminate on an error. The user must 
recognize this situation, if it is being created, and use the variable NNMIN 
in the Options Data block to provide for it. (See Table 3-1: Options data 

input detail). For the hypothetical case described, the card: 

CC7 

NNMIN • 300 

must appear in the Options Data Block. 

A CMERG tape with the FA data in an acceptable input format for the 
form factor data block can be generated from a TRASYS run by specifying the 
tape option in subroutine FFDATA or NFDATA (see Sections 4. 3. 3.1 or 4. 3. 3. 2). 
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The correct implenenteCion of this option will cause the FA products Chet ere 
computed end/or reed in (nocmelly written only to the RSO cepe) to be written 
to the BCD fometted USERl Cepe. 

From Che stendpoint of TRASYS operetions, inforaetion in the form 
fector dete block is' used by the preprocessor Co define two form fector 
request metrices. If e fom fector dete block is not encountered in the input 
streem, the form fector request metrices defeulc everywhere to '•1.0. The two 
request metrices provide for both the soler end infrered wevebends. They ere 
idencicel unless semi-trensperent surfeces with different infrered end soler 
Crensmissivicies ere present. Most models do not use trenperent surfeces so 
cwc. sets ere not needed. The progrem hes been recently modified to detect 
this situetion end reduce the site of restert files by writing out only one 
netrix Co the RSO tepe. This cen be overridden so thet old restert tepes with 
two metrices cen be reed. (Reference verieble NFFSET, described in Section 
4.3.3, Form Fector Subroutines) 

A form fector request meCrix is a triangular matrix of Che seme form 
as a form factor matrix. It is used for detail direction of form fector 
computations, end finally for storage of the form factors. This is done as 
follows: prior Co computing each form factor, Che corresponding value in Che 

request matrix is examined; if it is zero or greeter Chen zero, it is presumed 
Co be a valid form factor and is left in the matrix unchanged; if less Chen 
zero, Che form factor is computed end stored in place of the negative number. 

The user should never attempt Co use FA data on a restart tape if it 
is necessary to change the node numbers from chose associated with the FA data 
when it was originally generated unless Subroutine RSMERG is used. (Reference 
Section 4. 3. 9. 3, Subroutine RSMERG). In the process of setting up the request 
matrices, the node array on Che restart cape is compered, node by node, with 
the currently active node array. When a difference is encountered, the "new" 
number in the currently active node array will override and -1.0 values will 
be placed in Che request matrices so that Che FA products Co/from Che "new" 
node will be computed. The correct way Co utilize the data on the restart 
cape is to retain all the old numbers for which valid FA data exists on the 
restart tape, then use the Correspondence Date block to change node numbers 
for Che final output. 
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Prior to any fom factor calculations, the following operations are 
perfomed on the request aatrix, in the order indicated . 

1. Matrix set everywhere to -1.0. 

2. Matrix overwritten with all fom factor * area (FA) products on 

RSl/RTI tapes. 

3. Values of 0.0 set per ZERO cards. 

4. Values of 0.0 set per ONLY cards. 

5. Values of -1.0 set per RE COMP cards (overrides values on restart tape). 

6. Set individual FA values per fom factor data cards. 

Operations 3 through 6 happen only if a fom factor data block is 
present. Note t lat these operations enable the user to: a) Arbitrarily set 

all fora factors from a given node to sero if it is known to be "out of sight" 
of the remaining nodes; b) Compute only the fora factors from selected nodes, 
setting all other fora factors to sero; c) Recompute FA values known to be in 
error on the restart tape(s); and d) Set individual FA values to any value 
desired. If no RSI tape is present, operation 2 of course does not occur and 
operation 3 is meaningless. The remaining operations occur as listed. 

The above discussion applies to a single problem geometry. If more 
than one geometry e::ists in a given job, multiple sets of request matrices are 
involved. The form factor data block provides for definition of as many 
request matrices as required. 
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3. 3. 5.1 Verieble Definitione 


Fora factor data block designators are defined in Table 3-V. 
Table 3*V Form Factor Designators Definition 


COL. 1 DESIGNATOR 
VARIABLE NAME 

RANGE 

DEFAULT 

VALUE 

DESCRIPTION 

F xG 

Hollerith, 6 
Characters, Max. 

None 

Configuration Name. 

Must follow Header Card* 

NODEA 

1-99999 (Integer 
Array) 

None 

Node Identification 
No. Array. If required. 

IR, SOL, BOTH 
or BLANK 

N/A 

Both 

Indicates data for 
IR, Solar or Both 
Request Matrices. 

ONLY 

N/A 

None 

Indicates "ONLY" option. 

ZERO 

N/A 

None 

Zero's entire matrix. 


*FIG Cards immediately follow the header card and also begin each set of form 
factor data in a mult i*configurat ion run. 
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3. 3. 5. 2 Form Factor D«t« Fonnats 


1) FIG card* ara antarad according to tha following format; 


CCl 

FIG 


CC7 

CNAME 


CC7 

2 


2) The NODEA array is antarad according to tha following format 


CCl CC7 

NODEA NNl. NN2, . . . NNN, END 


CC7 

2 


for an N-Noda matrix. Tha NODEA array, if required, must follow 
the FIG card. If either the BCS dup or image option was used in 
the surface data block, tha node numbers must be entered in the 
same order they appear in the surface data, provided they are under 
active BCS names. If BCS dup or image was not used, the node 
numbers must appear in the order that results from the BUILD cards 
or BUILDC/ADD sequences. For these reasons, the chances of a 
user-written node number matrix being valid for a large problem are 
remote. VNien a node array is needed, use Subroutine FFNDP (Ref. 
Section 3.3. 5.6) . 

NOTE ; Tha node array is required only when individual form factors 
are to be defined in the form factor data block, or when equivalent 
form factors (Section 3.3. 5.4) appear. If all records in the form 
factor data block utilise one of the condensed formats pertaining 
to an entire row and column, then a Node Array is not required. 
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3) The ZERO card is entered according to the following format. * 

CCl CC7 

ZERO 

The ZERO card will put 0.0 into the entire Form Factor * area matrix. 

4) The ONLY option is implemented as follows: 

CCl CC7 CC7 

2 

ONLY NA, NB, NC, ND . . . 

Results in only the form factor rows from each node in the list NA, 
NB, MC, etc. being computed. All other form factors in the 
matrices will be set to zero. Applies to both wavebands. 

5) Single FA products are entered according to the following format: 

CCl CC7 CC7 

2 


WBAND NA, NB, DV 

where: NA, NB, and DV correspond 

respectively to I, J and the FA 
product in Che expression: 





DV 


6) Multiple*repeated FA products involving a single node are 

entered according Co Che following formac: 

CCl CC7 CC7 

2 

WBAND NA, NB, NC, DV 
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This will result in an FA product equal to DV being entered in the 
row of the request netrix corresponding to node NA, for columns 
corresponding to nodes NB through NC, inclusive. 

7) A request Co recompute FA products is implemented ss follows: 

CCl CC7 

WBAND NA, NB, REOOMP 

or 

WBAND NA, NB, R 

Recomputes FA product from NA to NB. 

WBAND NA, RECOMP 

or 

WBAND NA, R 

Recomputes FA products co/from NA from/Co ell other nodes. 

8) To zero FA products by individual node pairs or for ell node pairs 

for a specific node can be implemented as follows: 


CC7 

2 


CCl CC7 

WBAND NA, NB, 0.0 


CC7 

2 


Results in zero value for form factor from NA to NB. 


CCl 

CC7 


CC7 




2 

WBAND 

NA, 

ZERO 


WBAND 

NA, 

Z 



Results in zero form factors from NA to all other nodes. 
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3. 3. 5. 3 Form Factor Pets Block Exsmple 

An exsmple of a form factor data block is presented in Figure 3-18. 

3. 3. 5.4 Equivalent Form Factors 

Many radiation enclosures involve geometry that is symmetric in some 
manner and may, therefore, have many form factors that are exactly equivalent 
to other form factors because the node pairs involved are the same site and 
shape and "see" each other in the same way. The analyst can identify these 
situations, and if he can conveniently enter this information, a considerable 
amount of computer time may be saved in form factor computation. This 
capability has been provided, and the following sections describe the required 
form factor data block input. 

3. 3. 5. 4.1 Equivalence Data Formats 

Form factor equivalence data records appear in the form factor data 
block in the following format: 

CCl CC7 

WBAND NTv)I, NNJ, NNK, NNL, DV 

If the FA product DV is absent, the FA product from NMI to NNJ will be 
computed or obtained from a restart tape. 

The first four variables are integer node numbers. The four numbers 
are interpreted to mean the form factor from NNI to NNJ is equal to the form 
factor from NNK to NNL. In common with the other form factor data, only one 
record of five numbers or less with the coimna delineators may appear on a card 
(except :or the node array). 

In addition equivalent form factors can be generated automitically by 
the program for duplicated and imaged block coordinate systems. This can be 
imple>r.ented via th<<: "B" card in the surface data block (see Sections 
3.3.3.10: Dup and Image Options and Section 3.3.3.11: Equivalent Form 

Factors) . 
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SCI 


CC7 


HEADER 

FIG 

NODEA 

IR 


ONLY 

SOL 


zm) 


FORM FACTOR DATA 
AFTEND 

10, 17, 20, 24, 32, END 

10,20,12.4 $ DEFINES FA FROM NODE 10 TO NODE 20 (BOTH BANDS) 
DEFINES FA FROM NODE 10 TO NODE 32 (IR WAVEBAND) 
ZEROS ALL FA'S FROM NODE 24 (BOTH WAVEBANDS) 

$ EQUIVALENT FORM FACTORS 
$ COMPUTE ALL FF'S FROM AND TO LIST OF MODES 
$ RECOMPUTE SOLAR rORM FACTCRS FROM NODE 10 
COMPUTE FFS FROK NOD's 32 BY UHT.f-SPHERE METHOD 
COMPOTE FF FROM 17 TO 20 BY UNIT-SPHERE METHOD 
ZERO'S ENTIRE MATRIX 


10,32,6.2 $ 

24, ZERO $ 

10,32,17,20 
10,20,24,32 
10, RECOMP 
32,U $ 

17,20,U $ 

$ 


Figure 3-18 Form Factor Data Examples 


3 . 3 . 5 . 5 Selective Unit Sphere Form Factor Computations 

In the form factor data block the user has an option to specify that 
selected form factor computations be performed utilising an accelerated, 
non-shadowing Nusselt Unit Sphere method. This feature is only available for 
nodes that are planar (except discs) and nonshadowed, and neither node of a 
node pair is intersected by the plane containing the other. Although its 
utility is limited it is a very accurate and fast solution. The user may 
specify this option as follows: 


CC7 

NA, ML, U 
NA, U 


Tn the first example if nodes NA, NB are planar, an unshadowed form 
factor between nodes NA and NB will be computed by the unit sphere method. In 
the second example, assuming all planar nodes, the form factors from/ to node 
NA will be computed utilising the accelerated unit sphere method. 
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These computetions would override sny corresponding RSI date and 
require the user to specify the FFCAL link in the Operations Data block. 

3. 3. 5. 6 Punching a Node Array-Subroutine FFNPP 

Writing a node array for a large complex problem is exceedingly prone 
to error, yet a node array may be required (reference Section 3.3.5.'.) in the 
form factor data block, shadow factor data block (reference Section 3*3.6) or 
flux data block (reference Section 3.3.7). Subroutine PFNDP may be used to 
obtain a node array punched in form factor data format. This may be done in a 
preliminary run, (when node plots are generated for instance) and the User 
will then have an error'*free node array to use. The operations data calling 
sequence is: 

CC7 

CALL FFNDP 
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3.3.6 Shadow 
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3.3.6 Shadow Factor Data 


3. 3. 6.1 Baaic Concapta 

Shadow factors aia fractional nuabars that dascrlba tha aaount of 
shadowing (blockage) ancountarad by colliaatad anargy incident on a nodal 
surface. A shadow factor of one indicates no blockage, zero indicates lOQ 
percent blockage. Blockage results froai other parts of tha spacecraft or fron 
tha surface itself, if nonplinar. 

Shadow data consists of tables of shadow factors, two tables par 
node. (IR & Solar) These are 171**point bivariate tables. Whan the direction 
to an energy source is specified, using clock and cone angles, (see Figure Cl 
“ Energy Source Direction for Shadow Tables) the clock and cone angles are 
used as argusients in a double-linear interpolation that returns a shadow 
factor to be used in computing Solar, Albedo and Planetary direct irradiation 
according to: 

shadowed nonshadowed 

The 171 points result from all combinations of 19 clock angles and nine cone 
angles, spaced as described in Appendix C. 

Precomputing DI shadow factors for a given configuration is an 
approach that should be utilized with caution, for there are no straight 
forward ways to define its practical limitations. The concept is to save 
computer time by minimizing the repetitious or near repetitious computations 
that normally occur in the direct incident flux for any given node when one 
considers the look angles to the sun and to each node on the earth for every 
orbit point evaluated within a given execution, and from one execution to the 
next. Whether the approach is a practical one for the user, depends upon: 

1. How sensitive the critical areas of the model are to accurate heat 
rnre computations. Obviously, for example, if the model is enclosed with 
external insulation the external surfaces will be considerably more sensitive 
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than tha inctrnal parts whara tha haat will ba raradiatad, and storad in tha 
structura and/or raaovad by an activa tharaal control syataa. In this 
situation if thara ara no critical axterual surfacas thara is a raasonabla 
chanca tha siodal is insansitiva to tha errors that would ba introducad with 
tha application of tha shadow tablas. 

2. Tha coaplaxity ot cna stiaaowvns say r*ouira ssMllar look angla 
(clock and cons) incranants than currant ly usad in TRASYS. Tha linacr 
interpolation batwaan tha discrete points in tha table aay introduce 
significant errors. Tha prograa has a built in safeguard to liait the error 
whenever tha interpolation involves shadow table diffarancaa greater than 0.5 
for direct solar flux and 0.75 for planetary and albedo fluxes. In this 
situation tha prograa will not use tha tables , but instead coaputa tha 
shadowed flux values by using tha usual shadow routines in tha prograa* s 01 
sagaant. This will taka greater coaputer 'ice, and soaa of tha advantage in 
computational spaed with the application of tha shadow table will ba lost. 

Tha user aay override these and related shadow table utilisation paraaatars 
using Subroutine DISTAB. (Reference Section 4. 3. 5. 9: Subroutine DISTAB) 

Note that in earlier versions of TRASYS tha shadow factor data was 
rounded off and carried with one significant daciaal place. Now tha prograa 
no longer pecks the data, and instead stores tha shadow factors with no loss 
rn accuracy. 

The shadow factor data block functions to provide a punched card entry 
point for shadow factor data that is known in advance, and to direct tha 
updating of existing shadow factor data on a restart tape (RSI). 
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3. 3. 6. 2 Varicblt P«finitioM 


V ARIABLE NAME PESCRIPTIOil 

PIC Coafiguration Nmm (Hoilcrich, A charcctcra, mx.). 

NODEA Node Nuaber Array 

RECOMP Indicatta RECOMP option 

TABLE Indicatta a coaplata ahadow •'abla input 

WBAMO Indicatta tntrty wavtband opt^ona: IR» SOL, 

BOTH. Dtfaulta to BOTH. Tht ahadow factora ahould 
bt tht aaac for both wavtbanda txctpt whtn aurfacta 
with tranaaiaaivitita grtattr than ctro art utiliatd. 

3. 3. 6. 3 Shadow Data Foraaf.a 


MODEL and NODEA art tnttrtd according to tht following foraatat 
CCl CC7 

FIG CONFl $ (any Holltrith naat up to 6 :haracttra) 

NODEA DVl, DV2, DV3 DVN, END $ (inttgtr nodt 

nuabera). Tht uatr aay havt tht prograa 
rtgtntrate cht Nodt Array (act Sect' i 3. 3. 5.6: 
Punching a Node Array — " Subroutine FFNDP) in a 
prtliainary run. 
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Instructions to recompute shadow factor tables for a specified list of 
nodes are entered as follows: 

CCl CC7 

RI^COIMP DVl $ (integer node numbers) 

RECOMP DV2 


Note that this input only applies when an RSI tape with shadow data is present. 
A complete shadow factor table for one node is entered according to: 

CCl CC7 


TABLE 


WBAND, NN, 


Cl, 

DVl, DV2, 

DV19 

CM 

o 

DVl, DV2, 

DVl 9 

It 

II 

It 

It 

II 

II 

If 

If 

It 

If 

If 

If 

II 

It 

ff 

If 

C9, 

DVl, DV2, 

DVl 9 


The mnemoaics Cl through C9 refer to the 9 cone angles in a shadow 
factor table. The 19 data values following are for the 19 clock angles in a 
shadow factor table. If a cone number mnemonic is omitted, the 19 data values 
associated with it default to zero (100 percent shadowed). If less Chan 19 
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data values are entered following a CX mncaonics, the data values enc*'untered 
are stored consecutively beginning with Clock 1< For exanplO) if 

CX, DVl, DV2, DV3 DVN (N 19 or less) 

is encountered, the shadow factors for cone angle X, clock angles 1 through N 
will be DVl through DVi). The shadow factors for clock angles N -s 1 through 19 
will default to sero« 

Repeated data values may be entered using the repeat option for array 
data. For example, the card: 

CC7 

C6, REPEAT, 0.5, 12, REPEAT, 0., 7 

will enter shadow factors of 0.5 for clock angles 1 through 12 and 0. for 
clock angles 13 through 19 in the cone angle 6 array. 

The user is referred to the description of the shadow factor table 
format (Appendix C) for an explanation of the way the clock and the cone 
angles relate to the energy source/vehicle orientations used in shadow factor 
generation. If a punched node array is desired to avoid error, subroutine 
FFNDP may be used (See Section 3.3.6. Punching a Node Array “ Subroutine 
FFNDP). 


3. 3. 6.4 Shadow Factor Operations Detail 

Examples of shadow factor operations are shown in Figure 3-19. 
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(s) Shadow Factor Data, No Restart (*RSI-) Tape 

HEADER SHADOW DATA 
FIG ATTEND 

NODEA 101, 102, 103, 104, 105, 110, 120, 130, 140, END 
C INFRARED SHADOW TABLE 

TABLE IR, 101, C2, REPEAT, .1, 5, .5, .4, .4, .3 
C9, REPEAT, .4, 19 

C SHADOW TABLE FOR BOTH WAVEBANDS 

TABLE 105, Cl, REPEAT, 4, .5, REPEAT, 15, 0. 

(b) Shadow Factor Data With Restart Tape 

HF*DER SHADOW DATA 
FIG PLOAD 

NODEA 10, 21, 22, 23, 24, 25, 31, 32, 33, 70, END 

C RECOMPUTE DIRECTION 

RECOMP 21 
RECOMP 24 

C SHADOW DATA TO OVERRIDE DATA ON -RSI- 


TABLE 

31. 

C6, 

REPEAT, 

19 

TABLE 

32, 

C6, 

REPEAT, 

19 


Figure 3-19 Shadow Factor Operations Detail 
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3.3.7 Flux Data 
3.3.7.1 Basic Concepts 

The Flux Data block provides a punched card and/or CMERG tape (see 
Section 3. 2.2.3) entry point so that the user can selectively contro- the 
Direct Incident (DI's) Flux data computations. If an RSO tape is assigned 
while the DICAL segment or DIREAD subroutine is executed the DI's will be 
written to the RSO tape and can be read if that tape is assigned as an RSI 
tape on a subsequent run. No Flux Data block is required for a restart run if 
no changes have been made in the number of active nodes t their numbers and 
sequence and the user desires to: 

1. Use the previously stored data on the RSI tape in its entirety or 

2. With the utilization of CAll RSTOFF and CALL RSTON (see Section; 

3. 3.9. 7) in the Operations Data block the Flux data stored in specific 
step(s) can be selectively read or by*passed as complete step(s). 

A flux data block is required when: 

1. The user wishes to recompute some of the data values stored on a 
valid RSI tape. The reason for wanting to do this might be that a 
better DI accuracy needs to be specified by the user in subroutine 
DIDTl (see Section 4.3.5. 4) or the geometry was changed because one or 
more node(s) were moved. 

2. The user wishes to set specific flux data values to override the 
associated data values read from a valid RSI tape and by*pass the 
program computions normally performed. 

3. The node array stored on the RSI tape for a given configuration 
name will not match the node array of the active configuration created 
by the ”BUILD** card (see Section 3. 3. 9. 4). This would occur if after 
the user created the RSI tape, changes were made to the model that 
changed the number of nodes, or the node numbers, or the sequence. 
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If the user can determine that a significant portion of the data is 
still valid, the data can best be retrieved by utilising the appropriate CMERG 
tape as a means of selective data entry in the Flux Data block. A suitable 
CMERG tape with the data in an acceptable input format for direct input to the 
Flux Data block can be created by specifying the tape option in subroutines 
DIDTl or DIDTIS (see Section 4. 3. 5.4). The appropriate implementation of this 
option will cause the Dl's computed and/or read in from the RSI tape to be 
written to the USERl tape on a preliminary run. This former USERI output tape 
can be used as a CMERG tape on subsequent runs, to allow the user to 
selectively input data in the flux data block (see Section 3. 2. 2. 3). After 
the last write to the USERl tape the user should include in the operations 
data block an END FILE NUSERl and a CALL LIST with the appropriate user 
furnished arguments (see Appendix D). The LIST subroutine will list all the 
data stored on the USERl tape and number each record (line) so the line counts 
will be known for CMERG edit conmands. 

From the standpoint of TRASYS operations, information in the flux data 
block is used to define the flux data request matrix. If a flux data block is 
not encountered in the input stream, the flux request matrix is set everywhere 
to -1.0. If it is desired to force the recomputation of fluxes, (overriding 
flux data on a restart tape, for instance), flux data values equal to -1.0 are 
entered for the appropriate nodes. 

The variables MODEA and STEPM are required in addition to the flux 
data. These variables allow the input data to be stored according to the 
proper node numbers and points in orbit (step numbers). If a punched node 
array is desired to avoid errors, use subroutine FFNDP (Reference 3. 3. 5. 6: 
Subroutine FFNDP). 
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3. 3. 7. 2 Variable Definitions 


VARIABLE HAME DESCRIPTION 

NODEA Node identification number array 

STEPN Step number that following flux data applies to 

INITL Value that fluxes may be initialised Co (Optional) 

The input value for INITL will override Che RSI data 
values unless sec to -2.0 

A FIG card is not used iZi Che flux data block because step numbers are 
Che significant label for flux data storage. 

3. 3. 7. 3 Flux Data Formats 


1} NODEA, STEPN, and INITL are entered for each step according to the 
following order and formats: 


CCl CC7 


NODEA 

STEPN 

INITL 


NHl, NN2, , NNN, END 

NDV 

DV 


CC7 

2 


The user may have Che program generate Che node array (see section 
3. 3. 5. 6) in a preliminary run. 

2) Flux values may be entered in either of two formats. The 
quadruplet format is as follows: 


CC7 

NODID, DVl, DV2, DV3 

101,232., 114., 99. *.317 $ example 


CC7 

2 
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where: 


NODID “ node identification nuaber 

DVl ■ incident solar flux 

DV2 ■■ incident albedo flux 

DV3 ■ incident planetary infrared flux 

Reatrictiona: 

One quadruplet only per card. 

All four data values are required. No default logic applies. 

2 

Flux values aniat be in TRASYS standard units (Btu/hr-ft ). 

The single value formats are as follows: 

CC7 CC7 

NODE » NDVl, SUN • DV2, ALB - DV3, PLAN - DV4 
or 

NDVl, S ■ DV2, A - DV3, P - DV4 


Where: 

NDVl * node identification number (integer) 

DV2 ■ incident solar flux 
DV3 ■ incident albedo flux 
DV4 ■ planetary infrared flux 

Restrictions: 

All data values encountered between NODE values pertain to the 
preceding node number. 

3. 3. 7.4 Flux Data Block Example 

An example of a flux data block is shown in Figure 3-20. 
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HEADER 

NODEA 

STEPN 


NODEA 

STEPN 


FLUX DATA 

10, 17, 20, 24, 32, END 
10 

10, 2.79 * 144., 0., 0. $ FLUX ON SUN-ORIE.'ITED SURFACE 
17, 0., 25.74, 14.8 

NODE - 20, SUN - 0., ALB - 25.74, PLAN - 14.8 

10, 17, 20, 24, 32, END 
11 

32, -1., -1., -1. $ RECOMPUTE RUXES FOR NODE 32, STEP 11 


Figure 3-20 Flux Date Block Example 
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3.3.8 Corr«>pond«nc* D«t« 

3. 3. 8.1 B«»ic Concepta 

The correspondence dett block perforsw the function of providing the 
user with sn input point for the node nusd>ering data necessary to aake his 
thermal radiation suxlel correspond on a one-to-one basis with his thermal 
analyser RC (Resistance Capacitance) model. 

The user has the choice of using the information in this block to 
combine form factors (CMCAL) or to apply it in the absorbed heat output 
(QOCAL) and radiation exchange output (RKCALt RCCAL) processor segments. Two 
sources of error arise with form factor combining, however. If surfaces with 
differing optical properties are combined the radiation interchange 
computations are approximate because they proceed on the basis of 
area-wei^ted average optical properties. The second source of error is the 
so-called "fence" problem. Consider the 4-node configuration: 


3 


4 


1 


2 


Clearly, form factors between nodes 4 and 1 and 3 and 2 oo not exist. If 
nodes 1 and 2 were combined, however, form fsctors ^ 3 .^ 2 ^ 4-1 2 

exist, and GBCAL calculations would produce a radiation interchange factor 
between 3 and 4, obviously incorrect. Obviously this can cause erroneous ab- 
sorbed heating computations also. 


FulOZDm PAGE BUNK NOT RLMED 
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Th« uicr uy avoid thasa situationa by splitting his corraspc'danca 
data. Ona sat of eorraspondanea data, with no optical proparty coabination or 
fanca problans, is antarad and usad in fom factor coabining. Tha raaaining 
eorraspondanea data nacassary to aaka tha TRA8YS aodal agraa with tha RC aodal 
is antarad saparataly, and will ba applied only in tha absorbad heat and 
radiation intarchanga output sagaants. This assuaas tha usar can idantify 
corractly all of tha potantial arrors inharant with for* factor eoabining. 

Tha fro* factor coabining capability was davalopad to ainiaita tha 
partitioning for tha SMtrix invarsion in tha gray body (GB) sagaant, by 
reducing the aatrix sisa, and thus tha I/O cost associated with partitioning 
in the original version. Subsequent davalopaant and axparianca has shown that 
it has outlived its usefulness even for aodels as large as 800 nodes, 
especially when one considers tha pitfalls associated with fora factor 
coabining. The prograa was originally designed to operate in 65000K daeiaal 
core. For the gray body segaent the prograa dynaaically assigns all of the 
available core to the aatrix Inversion solution. Whan tha nuaibar of nodes 
exceeds between 200 and 250 for 6SK core the aatrix aust be partitioned on a 
disc file with only a portion resident in core. Additional core can be 
utilized to eliainate or further reduce the degree of partitioning. Even when 
partitioning is necessary two iaproveaents to the original prograa have 
eliainated, even for the 700 to 800 node sK>dels currently considered, aost of 
the advantages of fora factor coabining. The aost significant iaproveaent to 
the Univac version was to replace the inefficient standard Foreran 1/0 
operations involved with the partitioning with a systea utility routine 
(NTRAN) that will transfer an entire array so that each operation requires one 
I/O transfer with no restrictions on block size. In addition the prograa was 
aodified so that Che partitioned aatrix inversion can be restarted at 
interaediate stages if RTO/RTI capes are used. This feature ainiaizes the 
losses if the aatrix solution is not coaplece due to aaxiaua tiae, etc. The 
fora factor coabining capability will be retained because it it feasible that 
as aodels grow, fora factor cosibining aay again becosM an attractive 
alternative. 
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Another ««t of eorretpondtnce datOf not entered by the ueer, but 
iaplicit t*' the proRreat i* the correapondence data file that autoaatically 
recoabinea polygona. The uaer haa control of uhether or not thia ia done in 
the CHCAL link (reference Section 5.11.)« Another autoaatie application of 
correapondence ia the optional capability to apply Che equivalent 
correapondence generated for BCS OOP and BC8 ZMAQE Optiona (reference Section 
3.3.3.10.3 and 3.3.3.10.4). Again the uaer haa control of uhether thia ia 
accompliahed in the CMCAL link. To utilise thia option the uaer ahould refer 
CO Section 3.3.8.5t Autonatic Generation of Correapondence Data. 

3. 3. 8. 2 Variable Definitiona 


Correapondence data block variables are defined in Table 3-VI. 



RANGE OR 

DEFAULT 


VARIABLE NAME 

OPTIONS 

VALUE 

DESCRIPTION 

FIG 

CNAME 

NONE 

CONFIGURATION NAME 

CF 

BLANK OR 

BLANK 

FLAG DESIGNATING TYPE OF 


FF 


CORRESPONDENCE DATA 
OPTIONS: 

FF: CORRESPONDENCE DATA WILL 

BE APPLIED TO FF's IN CM LINK 
BLANK: CORRESPONDENCE DATA WILL 

BE APPLIED IN THE QOCAL AND 
RKCAL/RCCAL LINKS 


Table 3-VI 

Correspondence Data Variable Definition 
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3. 3.8.3 Corr«tpond»nct D«f Fofta 

1) FIG cards art antarad according to cha following foraati 

OCX CC7 CC7 

2 

FIG CMAMB» CF 

2) Noda corraspondanca data ia antarad according to tha following 
format: 

CC7 

NODID ■ DVl, 0V2, DVH 

NOOID is an RC modal noda numbar (ona to six digits > intagar) and Ovl 
through OVM ara tha TRA8YS noda numbars that will ba combinad into noda MO* It*. 

3. 3. 8.4 C orraspondanca Data Block Structura 

Tha corraspondanca dat* found batvaan a card defining a configuration 
name and tha naxt confiirurstion -.I'TM dafinition card can ba thought of as a 
correspondence data sub^block. One of these sub-blocks is required for each 
unique geometry of the User's problcu, assuming node combine operations are 
required for each gaomskry. Two sub-blocks under the same configuration nenc 
nay ba used if a portion of Che co&bining is to ba dona in CMCAL and tha 
remainder in RKCAL and/or QOCAL. In this ct»t, two FIG cards arc used with 
different CM variables. This i.Cuation is illustratad in Figure 3-23. 
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3.3.8.S Au tomatic Generation of Correspondence Data 

BCS duping and imaging frequently leads to a situation where a good 
deal of correspondence data can be automatically generated. Code to do this 
is now in TRASYSi and the feature is exercised by a new correspondence data 
block input. The expanded correspondence data input formats are: 

NRCl - Nl, N2 NN • NRC2, NINC2 ' NRC3, NINC3 * 

or: 

NRCl - Nl, N2 NN ’ NRC2, BCSN2 ' NRC3, BCSN3' 

wher' : 

NRCl « the RC (resistance capacitance) model node number desired for 
the combination of original TRASYS nodes Nl through NN. 

NRC2 * the RC model node number desired for the dup or image 
combination of nodes 

Nl + NINC2 through NN + NINC2. 

BCSN2 is the BCS name used the first time the BCS containing Nl 
through was duplicated or imaged. BCSNJ is the BCS name for the second dup 
or image, and so on. 

NINC2 is the increment value specified on the BCS2 card; NINC3 is the 
increment on the BCS3 card, and so on* 

.^ote that the two inputs are equivalent in function. The first format, using 
the increment value, is recoimended . In the second format the BCS names 
stated are checked against the list of BCS names that appear in the surface 
data and the increments used on the appropriate BCS cards is then applied. If 
a BCS name match is not found, an error is generated. If the increment is 
specified, per the first option, no check can be made. Tb^ increment option 
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must be used, however, when the BCS containing nodes N1 thru MN is not a 
"root" BCS, that is N1 thru NN were created by a BCS dup or image operation. 
The following are examples of implementing the correspondence data generation 
feature. 


Referring to figure 3-21, assume that the user wants to combine nodes 
1, 2, and 3. Quite likely, nodes 11, 12, 13, and 21, 22, and 23 should also 
be combined. Normally this would require the following three cards in the 
correspondence data block: 

CC7 

101 - 1, 2, 3 
111 11, 12, 13 

121 - 21, 22, 23 

Either of the following single cards is now equivalent to the above three: 
CC7 

101 - 1, 2, 3’ 111, 10* 121, 20 
!01 - 1, 2, 3' 111, BCS2' 121, BCS3 

where nodes 1, 2, and 3 were duped/ imaged under BCS2 and again duped/ imaged 
under BCS3. Note that each tiise nodes 1, 2, and 3 are duped and/or imaged, 
another apostrophe delineator is required. 


21 



SCSI 4 14 BCS2 


Figure 3-21. Correspondence Data Generation 
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In figure 3-22, nodes 1, 2, end 3 were defined under BCSl end duped within the 
same BCS es 11, 12, end 13. BCSl wes then imaged in its entirety, creating 
nodes 21, 22, 23, and 31, 32, and 33. In this case, automatic correspondence 
data must be generated by: 

CC7 


101 - 1, 2, 3* 111, 10' 121, 20' 131, 30 

in the correspondence data block. The more complex "family tree" 
involved precludes the use of the BCS name option. 


BCSl 



21 


12 


BCS2 


31 



33 


Figure 3-22. Correspondence Data Generation 
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CCl 

HEADER 

FIG 


FIG 


CC7 


CORRESPONDENCE DATA 

YSIDE $ (NOT TO BE COMBINED IN CMCAL) 

50 - 10,17 
32 - 40,41,42 
6 ■ 61,62 

18 - 1,11*1018,20 $ DUP OR IMAGE AUTO-CORRESPONDENCE 

YSIDE, FF $ FFS TO BE COMBINED IN CMCAL 

25 • 2,4,6 
35 - 3,5,7 

Figure 3-23 Correspondence Data Block Exanple 
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-•3.9 Operations Dsf Block 

3*3. 9.1 Basic Concepts 

The operations block can be thought of as a digital computer program 
coded in a somewhat modified FORTRAN language* The most powerful statements 
in the block are calls to processor library subroutines followed by "link** 
calls to primary processor program segments* Interspersed with these 
statements might be FORTRAN statements used to redefine any of the program 
variables in the reserve name list (see Appendix A) or control constant list, 
calls to user-supplied routines in the subroutines block, and any branching 
statements required for direction of problem solution logic. The operations 
data block is converted by the preprocessor to subroutine OOPROG. This 
routine serves as the driver for processor execution* In general, the 
conversion is a one-to-one passover of FORTRAN statments. The segment 
execution calls (L cards) however, result in the operating system dependent 
language necessary to define an overlay execution. 

An operations data block for a problem involving one or more 
configurations of the model and/or more than one point in orbit consists of a 
series of modified FORTRAN stat^wnts which are divided into logical sections 
each of which begins with the definition of a new problem geometry (identifiea 
by a unique configuration name) and/or a new point in orbit (identified by a 
unique STEP number). Calculated data required for subsequent processor 
operations (with the exception of fluxes output by DICAL, DRCAL and AQCAL) is 
placed in out-of-core storage under the appropriate configuration name. 
(Reference Figure 3-24). Fluxes are placed in out-of-core storage under the 
STEP number that identifies the appropriate point in orbit. 

The operations data block logic is processeo in the oroer 
encountered. Each logical section (as defined above) must be serially 
executable, that is, no branching from one section ro another is allowed. 


ii 
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Figure 3-24 Program Data Storage Scheme 
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Do*loops may be used» but they must be located entirely within s sectioni that 
is I BUILDC/ADD cards and STEP cards must not be contained within a DO-Ioop* 

In addition^ L*cards must not fall within a DChloop because the indices are 
lost when the ODPFOG segment is overlaid and removed from cor<^« Also, 
multiple executions of any program segments other than NPLOT, OPLOT, or PLOT 
vithin a section will make later data retrieval impossible for that section. 
Statement numbers from 1 to 9999 may be used, and each statement number must 
be unique in the operations data block. All program control constants and 
variables in common at execution of the operations data block (subroutine 
ODPROG) may be found in Appendix A. This list is automatically extended by 
the program to contain any constants and arrays entered in the quantities and 
array data blocks. 

3. 3-9. 2 ORBGEN Option 

Writing an operations data block for the calculation of direct 
irradiation and absorbed heats for an extensive series of points in orbit can 
be a tedious, repetitive job. To alleviate this, the ORBGEN option is 
available. When an ORBGEN card is encountered in the operations data block, a 
package of preprocessor routines use the data on the card to generate the 
operations data code necessary to compute and/or read direct irradiation, 
absorbed heats, and print a set of heat rate vs time tables and integrated 
average heat rates in standard SINDA input formats. These tables may be 
thought of as a default output that prevents loss of computed data. All flux 
and absorbed heat data computed using the generated code is stored in the 
usual manner and may be retrieved, manipulated, and output in any way the user 
desires (see Section 3.3.7: Flux ^ita). More than one ORBGEN card can be 

used in the Operations Data Block. The initial Step Number is defined by the 
user on the ORBGEN card. 

The preprocessor generated card images created by the ORBGEN will be 
written to the first RSO file along with the rest of the input data, and given 
edit numbers. This will allow the user to edit the standro ORBGEN output to 
accomplish a non^-standard operation. For example, through the Edit Data block 
specific steps of the direct incident data from a previous ORBGEN run cam be 
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selectively utilized vis cells to subroutines RSTON end RSTOFF. Only the dete 
not conraon to both runs would heve to be cosiputed. Note: Editing ORBGEN 

output is e feeture not yet eveileble on the CDC version of TRASYS. 

ORBGEN cards ere defined es follows: 

Forme t 


CCl 

I ORBGEN 

Definitions 


CC7 

TYPE, TRUANI, TRUANF, NPT, IFO, TIMEI , ISTEP 


TYPE is a Hollerith variable defining the spacecraft orientation reference and 
pertinent orbit characteristics. Options are: 

INER: Spacecraft is in planetary orbit, inertial (sun or star) oriented. 

PLAN: Spacecraft is planet oriented. 

CIRP; Spacecraft is planet oriented, in a circular orbit. 

NOPL: Spacecraft is in a heliocentric orbit (no planet) • 

TRUANI is the true anomaly* at the first point in orbit 0 TRUANI 360. 

TRUANF is the true anomaly at the final point in orbit. If TRUANF ■ TRUANI 
360, data for a complete orbit will be generated. 

NPT is the number of equal true anomaly increments between the points for 
which fluxes and direct irradiation will be computed. If the planet shadow is 
not encountered by the orbit, NPT + 1 points will be computed. If the planet 
shadow is encountered, NPT + 2NS+1 points will be computed, thus describing 
the flux discontinuities at the planet shadow boundary. (NS is the number of 
times the shadow boundary is encountered.) 
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*Reference Figuie 4-7: Definition of cure anomoly and shadow entry/exit points 

IFO defines the Optional Inpuc/OutpuC Subroutines. Options for IFO are AQ, 

DI, DIR, ZEROI and ZEROS. If AQ, the incident and absorbed fluxes are 
computed. If DI, the incident fluxes only are computed. If ZEROI, all 
absorbed infrared flux values will be zero. If ZEROS, absorbed solar fluxes 
will be zero. If DIR, Che incident fluxes will be read in directly from a RSI 
(restart) Cape, and absorbed fluxes will be computed. The DIR option requires 
a complete set of flux values on the restart tape, because the DICAL segment 
is not loaded. 

TIMEI is che time in hours desired for Che initial step number generated by 
the ORBGEN card. 

ISTEP is the desired initial step number generated by che ORBGEN card. 

Options and Restrictions 


1) Prior Co entering an ORBGEN card, the orbit must be defined 
through a call to ORBITl or 0RBIT2. 

2) Orientation must be defined through a call Co ORIENT. 

3) Spin must be defined, if applicable, through subroutine SPIN. If 
spin is net zero, INER and CIRP are not allowable for TYPE. 

4) Problem geometry roust be defined prior to any ORBGEN card. 

5) Punch/cape flags and accuracy parameters must be defined through 
subroutine DIDTl or DIDTIS prior to an ORBGEN card. 

6) The QO segment is limited to 100 time-points. 

7) Multiple ORBGEN cards are permissible. 
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3. 3. 9. 3 Trijectory Tape Operations 

NOTE: This option not svsilsblc on CDC version. 

3.3. 9.3.1 Preflight Trajectory Tape - TRJCNI Option 

TRJGNl cards provide a function similar to ORBGEN when computing fluxes and 
absorbed heats to match time points on a NASA/JSC Preflight MPAD trajectory 
tape. TRJGNl cards are used in the same way as ORBGEN cards and the card 
images generated by the pre-proccssor when a TRJCNI card is encountered are 
written to the first RSO file with the rest of the input data and given edit 
numbers. 

TRJGNl cards are defined as follows: 

CCl CC7 

TRJGNl, TSTART, TSTOP, IP LOT , IFO, TING, STOL, PTOL, ISTEP 

Definitions 


TSTART * First time value on MPAD tape at which calculations are 
required. (Decimal hours) 

TSTOP - Last time point for calculations. (Decimal minutes) 

IPLOT - Orbit plot control flag. 

YES for plots and fluxes 
NO for fluxes only 
ONLY for plots only 

IFO “ Calculation control flag. Same options and function as IFO 
on ORBGEN card. 

TINC - Maximum time intr;rval allowed between time points. (Decimal 
minutes) 


L 


3-130 


Revision 3 


STOL - Mininum change in angular direction of the aun vector ~ 

between consecutive trajectory tape points - for which a new 
time point will be generated, in decimal degrees. Default 
is 5.0 degrees. 

PTOL - Same as STOL for vector to center of earth. Default is 15.0 
degrees. 

ISTEP - Initial step number generated by the pre-processor when it 
encounters a TRJGNl card. Default is 20000. 

Options and Restrictions 

1) ORBITl or 0RBIT2 must be called prior to TRJGNl cards with zeros 
in all but the first argument to define SOL, WSS & WDS. 

2) Trajectory tapes reference the MPAD shuttle body vehicle 
cooridinate system shorn in Figure 3-25 for planet and sun 
location. The TRASYS Vehicle Coordinate System (VCS) is made to 
coincide with this coordinate system when the TRJGNl card is 
used. If the central coordinate system (CCS) used in the TRASYS 
model does not concide with the MPAD body coordinate system, s 
call to CAIENT must appear prior the TRJGNl card. (Reference 
section 4. 3. 5. 3; subroutine ORIENT) In this case, the TAPE 
option in ORIENT is used and the appropiate rotations are 
specified to rotate the VCS into the CCS. 

3) TRAJ must appear in the options data block and the trajectory 
tape must be assigned in the runstream prior to preprocessor 
execut ion. 

4} Multiple TRJGNl caros are permissible. 
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S) Calls to subroutine SPIN ere not recoonnended for concurrent use 
with TRJCNl. 

It is recoBBsended that the user obtain a oump of the trajectory tape 
contents for guidance in setting up TRJCNl cards. 

3. 3. 9. 3. 2 Post Flight Trajectory Tape - TRJCN2 Option 

TRJGN2 provides a function sinilar to ORBCEN for computik.g fluxes and 
absorbed heats to satch points on a NASA/ JSC Post Flight MPAD 
trajectory tape. TRJGN2 cards are used in the same wa; as TRJCNl and 
ORBGEK cards and are defined as follows: 

CCl CC7 

TRJGN2 TSTART, TS70P, IPLOT, IFO, TINC, STOL, PTOL, ISTEP 

Definitions : 

TSTART - First time value on MPAD tape for which calculations are 
required. (Decimal hours) 

TSTOP '* Last time point fot calculations. (Decimal hours) 

IPLO’" - 0‘^BIT plot control flag 
.5 for plots and fluxes 
NO 'or fluxes only 
ONLi fo'. plots only 

IFO - Calculation control flag. Same options and function as IFO 
on ORBCEN card. 

TINC ~ Msxitnum time interval allowed between time points. (Decimal 
minutes) 


3 - 13 ; 
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STOL - Minimun change ja angulcr direction of the eun vector, 

between coneecutive trajectory tape points, for which a new 
time point will be generated in dacinal degrees. Default ^s 
v.O degrees. 

PTOL - Sane as STOL except foi vector center of earth. Default is 
15.0 degrees. 

ISTEP - Initial step nunber generated by the preprocessor when it 
encounters a TRJCN2 aerd. Default is 20000. 
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3. 3. 9. 4 BUILD Option 

This option provides the user the convenience of defining the geometry 
for a configuration (in terms of block coordinate system names) with a single 
card rather than through a series of user calls to subroutine BUILDC and ADD, 
as previously required by TRASYS I. 

Format 


CCl CC7 

BUILD CONFIG, BLKl, BLK2, BLK3 


CC7 

2 


I 


This is equivalent to the sequence: 

CC7 

CALL BUILDC (BLKl, 3HFIG) 

CALL ADD (BLK2) 

CALL ADD (BLK3) 

Note that the configuration name (CONFIG in the example) must begin to the | 

right of card column 6. The BUILD option may continue for as many cards as 
required to list all of the Liock Coordinate System (BCS) names that make up 
the desired configuration. A continuation character in column 6 is required 
when more than one card is needed. A BCS name should not be split between 
cards. 


A BUILD card with columns 7-72 blank will automatically default the 
Configuration name to the Model name given in the Option Data Block and all 
i Ss specified in the Surface Data Block will automatically be listed to 
comprise the configuration. If there is no Model name in the Options Data 
Block, then the Model name will default to THING. 

If the configuration name is the imarne as a BCS name and the BCS name 
does net exist in the configuration the preprocessor will flag the 
configuration name as an error. For example, if in the Surface Data Block 
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there are BCSs with the names NEW, BLKI, BLK2, and it is desired to build a 
configuration in the Operations Data Block with only BLKI and BLK2 this 
configuration cannot be called NEW. 


3. 3. 9. 5 Operations Block Formats 

1) Step number cards are punched according to the following format 

CCl CC7 CC7 

2 

STEP DV ( integer) 

where is t*he integer step number»with the allowable range 1 to 
99999. Positive step numoers are required in the Operations Data 
Block for only the DI and DR computation links. They must be 
specified by the user for each orbit point. If ORBGEN, TR.TGN1, 
or TRJGN2 is used, they will be specified by the program within 
the constraint of the ISTEP variable on the TRJGNl or TRJGN2 
cards. For other than DI and DR computations, the user may use 
positive step numbers as in TRaSYS I. If they are omitted the 
program will insert negative step numbers only where required. 
This eliminates the confusion TRASYS I users previously had on 
what constitutes a Step. The elimination of user step numbers 
was possible by replacing xt with a more meaningful label, the 
configuration name. 


2) Subroutine calls are made in the classic FORTRAN format, with the 
word CALL beginning in CC7. Calling sequences for each 
user-*accessible processor routine can be found in Appendix D. 


3) Computation segment (link) calls are made using the following 
format : 


CCl CC7 


L SEGNAM 


CC7 

2 
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Where SEGKAM is the name of one of the progam segments contained 
in the processor library. Appendix £ describes the processor 
segments and their functions. Currently allowable options for 
SEGNAM are; NPLOT, OPLOT, SFCAL, MFCAL^, FFCAL, NFFCAL, RBCAL, 
RTCAL.CMCAL, DICAL, DRCAL, GBCAL» RKCAL, RCCAL, AQCAL» QOCAL, 
SATCAL*,and PLOT. 

^ Not available in UNIVAC version 

3. 3. 9. 6 Operations Block Examples 

Operations block structure and function is illustrated by the listings 
of sample operations blocks in Figure 3-26. 

Sample 1 of Figure 3-26 is a single step operations block that 
generates three node plots of a single geometry* Sample 2 is a two-step 
operations block that generates form factor matrices for two geometric 
configurations. Sample 3 is a 17-step operations block that generates direct 
irradiation data at 16 points in orbit » including the planet shadow in/ out 
points. A geometry change at the shadow in/ out points is involved. Sample 4 
is a listing of the operations data block for a restart run that recalculates 
shadow factors, reads form factors, combined form factors, and gray body 
factors from the RSI tape, calculates radiation conductors (RADKs, AQ's and 
QO's are always calculated since they are not saved for restart), and 
recalculates direct fluxes using shadow factor tables. 
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SAMPLE 1 — OPERATIONS BLOCK FOR PLOT OPERATIONS 

HEADER OPERATIONS DATA 

C BUILD GEOMETRY 

BUILD C^:AME1,BNAME1,BNAME2,BNAME3 

C INITIALIZE FOR PLOT 1 

CALL NDATA(1,3HGEN,0,0,0,A20,1,3,2,0.,0.,37.,0,0,0) 
C INITIALIZE FOR PLOTS 2 AND 3 

CALL NDATAS (2,3H3-D,0,0,0) 

CALL NDATAS (3,1HX,0,0.0) 

C MAKE PLOTS 1.2 AMD 3 

L NPLOT 


SAMPLE 2 — OPERATIONS BLOCK FOR FORM FACTOR OPERATIONS 
HEADER OPERATIONS DATA 
BUILD CNAM£l,BNAMEl,5NAhh2,BNAME3 

C SET FF CALCULATION PARAMETERS (PRINTS FF'S, DOES NOT PUNCH) 

CALL FFDATA(0,.2,0,0,i.E-3,3HYES,0,0,0,0) | 

C COMPUTE FORM FACTORS 

L FFCAL 

C MOVE BNAME2 SURFACES 

CALL CHGBLK(BNAME2,0.,0.,25.,1,2,3,0.45. ,0.) 

BUILD CNAME2.BNAME1. BNAME2 

C CALCULATE FORM FACTORS WITH SAME PARAMETERS AS FOR CNAMEl 

L FFCAL 

END OF DATA 


Figure 3-26 Sample Operations Data Blocks 
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SAMPLE 3 " OPERATIONS BLOCK FOR TWO GEOMETRY ABSORBED HEAT PROBLEM 

HEADER OPERATIONS DATA 
STEP 1 

BUILD CNAM£I,BNAM£1,BNAM£2,BNAM£3 
C SET FF CALCULATION PARAMETERS, PUNCH FFS 

CALL FFDATA(0,.2,0,0,l.E-3,3HYES,0,0,0,0) 

L FFCAL 

C calculate GREY BODY FACTORS 

CALL GBDATA(4HBOTH,0,2HFF ) 

L GBCAL 

C SET RADK CALCULATION PARAMETERS, PUNCH RADKS 

CALL RKDATA(0, 0,0, 1000, 5HSPACE, 999, 0,0, 0,0) 

C COMPUTE RADKS 

L RKCAL 

C DEFINE ORBIT AND LOCATE SUN 

CALL ORBIT2( SHEAR, 0. ,90. ,0,0,0, 120. *6080. ,0.) 

C ORIENT- VEHICLE (CCS Z-AXIS TOWARD SUN) 

CALL ORIENT(3HSUN,1,2,3,0. ,90. ,0. ) 

C SET D1 COMPUTATION DATA 

CALL DIDT1S(0.,0,0. ,3HYES,0) 

C COMPUTE DIRECT IRRADIATION (DICOMP PARAMETERS DEFAULT TO COMPUTE ALL) 

L DICAL 

L AQCAL 

STEP 2 

C UPDATE TRUE ANOMALY, SET UP TO COMPUTE PLANET AND ALBEDO FLUXES 

TRUEAN “ 30. 

CALL DI COMP (1,0,0) 

L DICAL 

L AQCAL 

STEP 3 

TRUEAN =60. 

CALL DICOMP (1,0,0) 

L DICAL 

L AQCAL 

STEP 4 

TRUEAN =90. 

CALL DICOKPi 1,0,0) 

L DICAL 

L AQCAL 

STEP 5 

C SKIP OVER PLANET SHADOW 

TRUEAN =270. 

CALL DICOMP (1,0,0) 

L DICAL 

L AQCAL 

STEP 6 

TRUEAN -300. 

CALL D1COMP(1,0,0) 

L DICAL 

L AQCAl, 

STEP 7 

TRUEAN = 330. 

CALL D1COMP(1,0,0) 

L DICAL 

L AQCaL 

Figure 3-26 (cent) 
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STEP 8 

C STUFF TRUEAN - 0. DI and AQ VALUES (DUPLICATE POINT) 

CALL STFAQ(360. ,0,1) 

STEP 9 

C COMPUTE DATA AT SHADOW ENTRY POINT (DAYSIDE GEOMETRY) 

TRUEAN -SHADIN - .1 

CALL DICOMP(1,0,0) 

L DICAL 

L AQCAL 

STEP 10 

C COMPUTE DATA AT SHADOW OUT POINT (DAYSIDE GEOMETRY) 

TRUEAN “SHAOUT + .1 

CALL DICOMP( 1,0,0) 

L DICAL 

L AQCAL 

C PUNCH AQAVG,AQ VS. TIME TABLES - DAYSIDE 

CALL QODATA ( 3HALL , 0 , 2HNO , 3HYES , 0 , 0 , 0 , 4HBOTH) 

L QOCAL 

STEP 11 

C BUILD DARKSIDE CONFIGURATION 

BUILD CNAME2,BNnMEl,BNAME2,BNAME4 

C CALCULATE FFS (FFDATA PARAMETERS SET IN STEP 1) 

L FFCAL 

C CALCULATE GREY BODY MATRICES 

CAIL GBDATA (4HBOTH,0,2HFF ) 

L GBCAL 

C SET RADK CALCULATION PARAMETERS, COMPUTE RADKS 

CALL RKDATA(0, 0,0, 1000, 5HSPACE, 999, 0,0, 0,0) 

L RKCAL 

C REORIENT TO PLANET 

CALL ORIENT(4HPLAN,1,2,3,0. ,90. ,0.) 

TRUEAN =120. 

L DICAL 

C COMPUTE ABSORBED HEATS 

L AQCAL 

STEP 12 

C UPDATE TRUE ANOMALY, STUFF HEAT DATA FROM STEP 11 BECAUSE ORBIT 

C IS CIRCULAR, PLANET-ORIENTED 

CALL STFAQ(150. ,0,11) 

STEP 13 

CALL STFAQ( 180. ,0,11) 

STEP 14 

CALL STFAQ(210. ,0,11) 

STEP 15 

CALL STFAQ( 240. ,0,11) 

STEP 16 

C STUFF DATA FOP. SHADOW ENTRY POINT (DARKSIDE CONFIGURATION) 

CALL STFAQ( SHADIN + .1,0,11) 

STEP 17 

C STUFF DATA FOR SHADOW OUT POINT (DARKSIDE "CONFIGURATION) 

CALL STFAQ(SHAOUT - .1,0,11) 

C PUNCH AQAVG,AQ VS TIME TABLES - DARKSIDE 

CALL QODATA( ISARY , 0 , 2HNO , 3HYES ,0,0,0, 4HBOTH) 

L QOCAL 
END OF DATA. 

Figure 3-26 (cont) 
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Sample 4 — Orbit Generation from an ORBGEN Card 

C DEFINE ORBIT AND ORIENTATION 

CALL 0RBIT2 (EAR, 90. ,60. ,0,0,0. , 100*6080. ,0. ) 
CALL ORIENT (PLAN, 1,2,3,0. ,90 . ,0. 1 


c 

ORBIT GENERATION 

CARD FOLLOWS 

ORBGEN CIRP, 0.0, : 

360.0, 4, AQ, 0.0, 10000 

c * * 

********* 

ORBIT GENERATION STARTS HERE ********* 

STEP 

10000 



TRUEAN 

0. 


TRUANF 

360.000 


TRUANT 

0. 


lAI 

0 


IAS 

0 


PLTYPE 

CALL DICOMP(0,0,0) 

6HPLSAVE 

L 

DICAL 



NSPFF 

10000 


PLTYPE 

6KPLREAD 


CALL AQDATA(IAI,1AS,0,0,0) 

L AQCAL 
STEP 10001 

CALL STFAQ (TRUAN?,0 ,0 , 1000) 

STEP 10002 

TRUEAN - 90.000 

CALL D1C0MP( 0,0, 10000) 

L DICAL 

CALL AQDATA(IAI,IAS,0,0,C) 

L AQCAL 
STEP 10003 

TRUEAN «= 180.000 

CALL DIC0MP(0, 0,1000) 

L DICAL 

CALL AQDATA (I AI , I AS , 0 , 0 , 0 ) 

L AQCAL 
STEP 10004 

TRUEAN « 270.000 

CALL DICOHP(0 ,0,10000) 

L DICAL 

CALL AQDATAdAI, IAS, 0,0,0) 

L AQCAL 
STEP 10005 

IF(SHADIN.LT.O.) GO TO 90400 

TRUEAN * SHADIN-0.1 


Figure 3-26 (cont) 


U 
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IF ( TRUEAN . LT . TRUANI . OR . 
ITRUEAM.GT.TRUANF) GO TO 90000 

CALL DICOMP ( 0 , 4HZER0 , 10000 ) 

L DICAL 

CALL AQDATAdAI, IAS, 0,0,0) 

L AQCAL 

90000 CONTINUE 
STEP 10006 

TRUEAN - SHADIN40.1 

I F (TRUEAN . LT . TRUANI . OR. 
ITRUEAN.GT.TRUANF) GO TO 90100 


CALL DICOMP (0,0, 10000) 

L DICAL 

CALL AQDATAdAI, IAS, 0,0,0) 

AQCAL 

90100 CONTINUE 
STEP 10007 

TRUEAN - SHAOUT+0.1 
I F ( TRUEAN . LT . TRUANI . OR . 

ITRUEAN.GT.TRUANF) GO TO 90200 

CALL DICOMP (0,4H2ERO, 10000) 

L DICAL 

CALL AQDATAdAI, IAS, 0,0,0) 

L AQCAL 
90200 CONTINUE 
STEP 10008 

TRUEAN « SHAOUT-0 . 1 

IF ( TRUEAN . LT . TRUANI . OR . 

ITRUEAN.GT.TRUANF) GO TO 90300 

CALL DICOMP (0,0, 10000) 

L DICAL 

CALL AQDATAdAI, IAS, 0,0,0) 

L AQCAL 
90300 CONTINUE 
90400 CONTINUE 

CALL QODATA(3HALL, 0,0, 0,0, 0,0,0,) 

L QOCAL 
C 

C************ ORBIT GENERATION ENDS HERE *********** 

Figure 3-26 (cent) 
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Sample 5 Operations Block for Restart Run 

HEADER OPEBATIONS DATA 
STEP 1 

BUILD CNAME.BNAME 
CALL RSTOFF 
L SFCAL 

CALL RSTON 

CALL FFDATA(0,0,0,0,0,0,0,2HNO, 0, 0) 

L FFCAL 

CALL CMDATA(0,5HFFNEW,FF, 0, 0) 

L CHCAL 

CALL GBDATA(4HBOTH,0,2HCM ) 

L GBCAL 

CALL RKDATA(0 , 2HW0 ,0,100, 5HSP \CE , 999 ,0 , 0 , 2HNO ,0 ) 

L RKCAL 

CALL ORBIT2 (SHEAR, 0. ,90. ,0. ,0. ,0. , 100. *6080. ,0. ) 
CALI. U1DT2S(0,0. ,180. ,0. ,0. ,0. ,100. *6080. ,2HNO,0) 
CALL RSTOFF 
L DICAL 

END OF DATA 

Figure 3-26 (concluded) 
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3. 3. 9. 7 Restart Operetione 

The simplest restart operation is picking up a run interrupted by a 
system abort (e.g., time limit) where there is no requireoMnt to modify the 
input deck* This is accomplished by specifying RSI in the Options Data, using 
the previously generated RSO tape as an RSI tape and submitting the sane deck 
used on the previous run. If the data from the new run is to be saved RSO 
must also be upecified in the Options Data block. The sane thing can be 
accomplished by submitting an input deck consisting only of an Options Data 
block which must, of course, specify an RSI tape. This is possible because 
the entire input deck resides on the first file of the RSI tape. If the 
interrupted run used an RTO tape, it should be specified and mounted as an RTl 
tape when making the restart run. This enables the user to reclaim interim 
data from the FF, NFF, GB, RT, DI and SF segments. The RB, DR and CM segments 
are not set up to use the RTl tape. 

All restart operations involving more than a simple resumption of an 
interrupted run are accomplished through edit commands. All input decks used 
in this type of restart run will consist only of an options data block and an 
edit data block. Any data (numerical or logic) may be inserted or delated 
frost the input deck using edit commands. The editing is conveniently 
accomplished using the usual edit commands (see Section 3. 2. 2. 2: Edit Data 

Block) w''ile referring to the output listing from the previous rua foi line 
number information. The user should keep in mind that the input deck, as 
edited is written to the RSO tape. Therefore, when restarting from a tape 
generated by a previous restart/edit run, ^the previously used edit commands 
are not required, and .will in fact probably generate errors. 

In all TRASYS processor printout, when an RSO tape is used, restart 
tape record numbers are printed whenever information is written to the RSO 
tape. When this run ends, whether from Lime limit, abort or normal exit, 
there will be some record number, say for instance 100, near the end of the 
printed output. This means that presumably 100 records of valid information 
exist on the RSO tape. It is a peculiarity of the Univac system, as applied 
to TRASYS, that it cannot reliably differentiate between a parity error and 
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the end of information on an RSI tape. Thus, if this 100 record tape were 
used on a restart run, and a parity error was encountered at record 30, 
calculations would begin at record 50 and much of the data generated on the 
first run would be recomputed^ This may be necessary if there is a true 
parity error on the tape, but if the error was generated by the tape drive, 
half of a perfectly good tape would be wasted* This potential problem is the 
reason for allowing the user to specify RSREC. Had the card RSR£C"100 been in 
the Options Data block on the second run, the parity error would have resulted 
in an abort rather than recomputing* The abort would provide the option to 
try the run again to see if the parity error was spurious or really on the 
tape. If not specified, RSREC defaults to zero. 

Another UNIVAC-peculiar restart tape item is the format of the form 
factor psuedo file on the RSO/RSI tape. In general, two complete sets of form 
factors are required, one for solar and one for the infrared waveband. This 
is because distinct infrared and solar transmissivities are allowed for 
surface properties. This is not a common situation, however, and the majority 
of the RSO/RSI tapes just have two identical sets of form factors. The 
program was recently changed to eliminate toe extra set for problems with no 
semi-transparent surfaces* Reading in RSI tapes generated before this change 
now requires the use of the NFFSET varible in FFCAL and NFFCAL. (Reference 
section 4.3. 3.1: Subroutine FFDATA. ) 

Subroutine RSMERG has also been written for the UNIVAC version to 
allow merging of the form factor data from up to three RSO tapes into a single 
form factor * area matrix. The three tapes are identified as RSI, RS12 and 
EMERG when utilizing this capability. (See Section 4. 3.9.3: Subroutine RSMERG) 
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Cells to subroutinss RSTOFF end RSTON srs sditsd into the operations 
data block to give tbs user direct control over the reading of the processor 
data on the RSI tape. CALL RSTOFF says in essence, do not read the RSI tape 
until further notice* CALL RSTON says read it until further notice. The 
operations data begins as if an RSTON call was in effect. The use of RSTOFF 
can be illustrated using a coonon paraaetric study situation. Say that a user 
has generated rad;:ation interchange factors for a particular nodal and has the 

pertinent fom factors *00 gray body factors on a restart tape. He desires to 
change sone surface properties and generate new radiation conductors. This, 
of course, involves editing in calls to subroutine MODPR prior to the L GBCAL 
card. However, if a call to RSTOFF is not inserted ahead of the L GBCAL card, 
the gray body matrix residing on the restart tape will be read in, and the 
radiant interchange factors obtained will be identical to those of the 
previous run. For further background on RSTOFF and RSTON the reader is 
referred to Section 4.3.9: Restart Control Subroutines. 

The user should keep in mind that significant amounts of data suiy be 
lost when executing without an RTO tape. This is illustrated by the following 
explanations of the RSO/RTO write sequences: 

a) The FFCAL and NFFCAL segsients write to the RSO tape at the end of each 
row of fom factor computations. It writes to the RTO tape after every 
10 fora factors are computed. 

b) The fora factor combining link writes to the RSO after each row of form 

factors are combined. It does not write to the RTO tape. 

c) The DICAL segment writes to the RSO tape at the end of each orbital time 

point (step). It writes to the RTO tape after each 10 flux calculations. 

d) The SFCAL segment writes to the RSO tape after each nodal shadow factor 

table computation is complete. It does not write to the RTO tape. 
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c) The GBCAL segment writes to the RSO tape st the end of the matrix 

inversion process for each waveband* It writes to the RTO tape at the 

end of each of three steps in the process of inverting the matrix* 

f) The RTCAL segment writes to the RSO and the RTO tape at appropriate 
points* 

g) The RBCAL segment writes to the RSO tape after comj , ..ting each row of 
image factors. 

b) The DRCAL segment writes to the RSO tape after each orbital time point* 

Once the data from the RTO is passed on to the RSO tape, the RTO tape is 
rewound, and the next set of computations are written to the RTC tape to be 
saved temporarily until the time the data is again passed on to t le RSO tape* 
In reading a RTO created tape back in as a RTI tape, C ^ program will first 

read what it can from the RSI tape and then read the ^.7! fipp if available. 

After the one read it dynamically frees the RTI unit. 

3*3.9*8 Description of Restart Files 

3 * 3 . 9 . 8 • 1 Permanent Restart Output Tape ~ RSO 

A complete PSO tape consists of two files* The f''st file contains 
images of all cards in the input data that were present *.n ^he orit^inal run. 

In addition, this file contains the edit information that allow editing of the 
input data in subsequent runs. After editing, this file is processed by the 
preprocessor in the usual manner in preparation for processor operations. The 
second file contains data that was output by the procesr ! s gments as the 
user-defined Operations Data logic was processed. Not il processor output is 
written to the tape* Section 3.3«9*7: Restart Operations deilres the specific 
deta that is written to the RSO tape. 


3-UV 


Revision 3 


An alternate program and control card runstream for the Univac allows 
recovery from a system crash without loss of data, and bypasses the 
preprocessor when the run is re-started by the operator or the system after 
the crash* This version has nine files* For this version the first and last 
file (ninth file) are identical to the first and second files defined above* 
The second file contains the processor absolute element created in the 
previous run, and a copy of the first of eight temporary files used to pass 
data from the preprocessor to the processor* The third through eighth files 
are copies of the seven remaining temporary files* 

3*3. 9. 8. 2 Permanent Restart Input Tape - RSI 

The RSI tape is an RSO tape from a previous run that is used as input for 
a restart run* Input from this tape can be edited as required using edit 
statements. Data from tapes other than the RSI tape may be merged into the 
TRASYS model (first file of RSI tape) by adding CMERG or EMERG statements to 
the TRASYS model as required. As a reminder, CMERG fries are TRASYS input 
in BCD form. EMERG files arc the first files of other RSI/RSO tapes. 

3.3.9*8*3 Temporary Restart Output Tape - RTO 

The RTO tape is used to save partially completed calculated data in the 
DICAL, FFCAL, RTCAL, and GBCAL segments to minimize the amount of data lost 
upon run abort due to time limit, equipment failure, etc. 

J.3.9.8.4 Temporary Restart Input Tape - RTI 

The RTI tape is an R* . . ^^pe from a previous run that is used as input for 
a restart run. 
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3.3.10 Subroutine Data Block 


3.3.10.1 Basic Concepts 

The subroutine data block is a collection of FORTRAN language subroutines 
supplied by the user in order to extend or modify TRASYS capabilities for the 
problem at hand. These subroutines may be either user-addressable (from the 
operat' ■’s *^lock) or program-addressable, from the various computation 
segmen. . 

Unless the user is creating what amounts to a major rewrite of a 
computation segment, the program subroutines in his subroutine block will bear 
the same name as processor library subroutines. The effect of his name 
duplication is that the user-supplied routine in the subroutine data block is 
compiled in lieu of the processor library subroutine prior to execution. 
Removal of such a routine reactivates the like-named library routine. 

Three deviations from FORTRAN language are defined for the subroutine 
data block. L-cards are used to identify subroutines with particular 
processor segments, R-cards are used to alert the program to the beginning of 
a new subroutine (UNIVAC only) and the TRASYS COMMON cards are used to 
automatically supply program common to the subroutines. 

3.3.10.2 Subroutine Block Formats 


Subroutine data block format is illustrated in Figure 3-26. The segment 
names on the L-cards are strictly order-dependent. The L-cards with their 
associated subroutines need not all be present, but they must be encountered 
in the order shown below. Subroutines in the leading sub-block, with no 
L-card, are addressable only from the operations data block. 

No L-card 
L FFCAL 

L SFCAL 

L NPLOT 
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L OPLOT 

L DICAL 

L GBCAL 

L AQCAL 

L QOCAL 

L RBCAL 

L PLOT 

L RCCAL (or RKCAL) 
L DRCAL 

L CMCAL 

L NFFCAL 

L RTCAL 
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TRASYS COMMON cards are optional. When used» they serve to insert 
all labeled and blank common lists, associated with the segment named on the 
preceding L-card, into the subroutine. Appendix A-1 defines the variable 
names in common for subroutine ODPGl thru ODPGn, and the various segments. 

NOTE ; Subroutines immediately preceded by TRASYS COMMON cards will 
be compiled with both the operations data (ODPGl thru ODPGn) common blocks 
and the common blocks associated with the preceding L-card. This means 
that all quantities data and array data, which are normally accessed only 
in (ODPGl thru ODPGn), are available to all subroutines in the subroutines 
data block. 

Note that TRASYS CCWMON cards preclude beginning a subroutine block 
comment card with the word COMMON. 

R-cards must immediately precede each subroutine name card (UNIVAC 
only), with no intervening L-cards or TRASYS COMMON cards, 

3.3.11 End of Data Card 

The input deck should conclude with an END OF DATA card. If it is 
missing the pre-processor will assume one and write a caution message. 
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4. USER CALLED ROUTINES 


4.1 Basic Concept* 

User called routines tsay be defined as chose subroutines and 
computation segments callable from Che operations block. Unless one or more 
subroutines of this type are entered in Che user's subroutine data block, the 
user callable subroutines contained in the processor library comprise the 
entire list of user callable subroutines. Seg:?'ncs cannot be entered in the 
input stream. 

4.2 Processor Library 

The user callable processor library routines are listed below. In 
general, they are grouped according to their association with each of Che 
processor computation segments. Page references for the subroutine 
descriptions are included. See also Appendix D for summary descriptions of 
each library subroutine. 

4.2.1 Library Listing of Subroutines 



- 

Page 

Name 

liSl 

General Subroutines 

BUILDC 

4-5 

ADD 

4-6 


CHGBLK 

4-6 



Plot Package 

MDATA 

4-15 

ODATA 

4-19 

Subroutines 

NDATAS 

4-15 

ODATAS 

4-19 


PLDATA 

4-23 
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N—€ 

Paw 

Nama 

Paga 

Form Factor 

FFDATA 

4-7 

ADSURF 

4-13 

Subroutines 

CMDATA 

4-12 

RBDAIA 

4-14 


NFDATA 

4-11 

RTDATA 

4-15 


PFFSHD 

4-15 



Direct Irradiation 

ORB IT 1 

4-23 

(^IT2 

4-30 

Subroutines 

DlDTl 

4-34 

DIDTIS 

4-34 


DIDT2 

4-37 

DIOT2S 

4-37 


SPIN 

4-39 

ORIENT 

-30 


SPINAV 

4-40 

DITTP 

4-42 


DICOMP 

4-41 

DRDATA 

4-45 


DITTPS 

4-42 

DISTAB 

4-41 

Restart 

RSTON 

4-62 

RSTOFF 

4-62 


FFREAD 

4-67 

DIREAD 

4-67 


RSMERG 

4-62 



Radiation Inter- 

GBOATA 

4-46 

RKDATA 

4-47 

change Subroutines 

GBAPRX 

4-46 

RCDATA 

4-49 

Absorbed Heat 

AQDATA 

4-53 

STFAQ 

4-54 

Subroutines 





Absorbed Heat 

QODATA 

4-54 

QOINIT 

4-55 

Output Subroutine 





Data Modification 

MODAR 

4-56 

HODPR 

4-58 

Subroutines 

MODTR 

4-58 

MODPRS 

4-59 


MODSHD 

4-60 

NODDAT 

4-61 
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Plsnet Surface 

DIDT3 

4*70 

DIDT3S 

4-70 

Subroutines 

SOLFP 

4-68 



A. 2.2 Library Listing of Piocessor Sessents 



Name 

P«Rg 

Name 

Pfl* 

Plot Package 

SPLOT 

E-2 

OPLOT 

E-2 

Segments 

PLOT 

E-2 



Form Factor 

FFCAL 

E-3 

CMCAL 

E-4 

Segments 

NFFCAL 

E-3 

RBCAL 

E-3 


RTCAL 

E-4 



Direct Irradiation 

DICAL 

E-5 

DRCAL 

E-5 

Se^nenta 





Shadow Factor 

SFCAL 

E-6 



Generator Segment 





Radiation Inter- 

RKCAL 

E-7 

atCAL 

E-8 

change Segments 

RCCAL 

E-7 



Absorbed Heat 

AQCAL 

E-8 



Segment 





Absorbed Heat 

QOCAL 

E-9 



Output Segment 
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4,3 Siubroutint Detcription* 

4.3.1 Ba«ic Conc«pt.<i 


The user'callablt subroutinaa in the procataor library fall into tvo 
functional groups. Tha aosC nuaaroua group conaiata of aubroutinaa uaad to 
dafina tha prograa variablaa and aat tha logic flaga that ara required before 
a coBputational aapaant can be linked into tha procaaaor and executed. 

Variable definition in thia aanner, aa oppoaed to definition froa the data 
blocks, achieves tvo inportant goals. First, in any coaplez problea aany 
segment calls are aade, necessitating frequent redefinition of program 
variables. Under theae conditions, data block input would be redundant. 
Second, the subroutine calls, in classic FORTRAN format, fora natural groups 
of input variables, and as the calls are input serially in the user's 
operations block, he is provided a hi^ly visible presentation of the variable 
definitions existing at each stage of his execution. Thus, if the user 
carefully proofreads a listing of his operations block, his logic and variable 
definitions should be error-free. If his geometry inputs have been verified 
using the plot peckage, the user may proceed with some confidence to consume a 
large block of computer time. It is the hope of the TRASYS designers that 
these features will ease somewhat the all to prevalent garbage in * garbage 
out syndrome. 

The second group of processor library subroutines perform data handling Casks 
chat eliminate redundant calculations. For example, direct irradiation nay be 
required at 15 orbit poiits for a sun-oriented spacecraft. Armed with the 
knowledge that his solar flux it everywhere constant (outside Che planet 
shadow), the user may compute Che solar flux in Step 1, then use Che STFAQ 
routine to retrieve Che data from Step 1 and place it in data storage for any 
of Che other 14 steps he desires. 
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App€ndix D it coapoiittd of siaHiary dotcriptioiM of ««ch user 
•ubroutint. Dtfiniciont of oach variable in eha calling aaquancat ara givany 
Cogathar with thair default valuaa, where applicable. Tha additional utarial 

necaasary to uaa the aubroutinas ia praaantad in the remainder of thia 
aaction. After achieving a working knowledge » the uaar ahould find Appendix D 
aufficiant for hia quick'*rafaranca naada. 

4.3.2 Canaral Subroutinaa 


Subroutinaa BUILDC and ADD and the BUILD card (aaa Sactiona 3. 3. 9.4: 
Build Option) are uaad to chooaa, from the varioua blocka of aurTacaa in the 
aurfaca input data, what blocka arc to be aaaamblad to create (build) the 
problem geometry (active configuration). Alao» the relative apatial p.->aitiona 
of the aurfacea and nodei in the active blocka stay be changed uaing aubroutina 
CHGB1.K, pr5or to building the active configuration. 

4.3.2. 1 Subroutine BUILDC 


Calling Sequence: CALL BUILDC (BCSNAH, CONFIG) 

Thia aubroutina begina the proccaa of aaacmbling the geometry deaired 
from the blocka of aurfacea in the aurface data block. BCSNAM it any block 
coordinate ayatem name found in the aurface data block. If nc BCS > i named in 
the aurface data block, CALL BUILDC (ALLBLK, NAME) will define a geowet.'' 
ctnaiating of the entire aurface data block. CONFIG ia any name (1 v.o 6 
character Hollerith string) choaen by the uaer to identify hia rctive model 
configuration. Thia call muat be made for geometry definitiona or after Block 
Coordinate Syatem redefinition via aubroutina CHGBLK. 
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Important Note: A BUILD card or a BUILOC call voids any previous BUILD/ ADD 

calls and any previous Surface Property Modification Subroutines calls • (e.g4, 
MODAR, MODPR). 

4. 3. 2.2 Subroutine ADD 

Calling Sequence: CALL ADD (BCSNAM) 

This subroutine adds another block of surfaces to the geometry defined 
by previous BUILDC and ADD calls. One BUILDC call must precede any ADD call 
in the operations block. 

Note: Direct calls to BUILDC and ADD have been made essentially obsolete by 

the BUILD card. See Section 3. 3. 9.3: Build Option, and Related 
Information for subroutine BUILDC in Appendix D. 

4. 3. 2.3 Subroutine CH6BLR 


Calling Sequence: CALL CHGBLR (BCSNAM, TX, TY, TZ, IROTX, IROTY, 

IROTZ, ROTX, ROTY, ROTZ) 

This subroutine is used to spatially relocate blocks of surfaces by 
redefining a block coordinate system's location and orientation in central 
coordinate system 3~space. BCSNAM is the name identifying the block 
coordinate system being changed. Its spelling must be exactly as called out 
in the BCS data block. 

The arguments TX, TY, TZ, ROTX, ROTY, ROTZ are the translation and 
rotation parameters necessary to transform the central coordinate system into 
the block coordinate system in its new position. These parameters are further 
discussed in Section 3.3.4.: BCS Data 
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The arguments IROTX, IROTY and IROTZ control the order in which the 
rotations ROTX, ROTY, and ROTZ are performed. They may take on the integer 
values 1, 2, or 3. For example^ for IROTX * 3, IROTY * 1, and IROTZ » 2, the 
rotations will be performed in the order ROTY first, ROTZ secoud, and ROTX 
third. If zero is passed for all three arguments, the default values IROTX ^ 
1, IROTY - 2, and IROTZ ^ 3 will result and the rotations will be performed 
ROTX first, ROTY second, and ROTZ third. 

4*3*3 Form Factor Subroutines 


The subroutine FFDATA is used to set the variables and control 
constants required before executing the FFCAL computation segment. An FFDATA 
call prior to all FFCAL executions is not mandatory because each FFDATA 
argument assumes a default value (ref. Appendix D). The variables defined by 
an FFDATA call will hold for any subsequent FFCAL executions in the operations 
block. 


Subroutine NPDATA accomplishes the same function for the Nusselt 
sphere form factor segment, NFFCAL. 

Subroutine GKDATA accomplishes a similar function prior to execution 
of the form-factor combining segment, CMCAL. 

4. 3. 3.1 Subroutine FFDATA 

Calling sequence: CALL FFDATA (FFACC, FFACCS, FFNOSH, FFRATL, 

FFMIN, FFPRNT, 7FPNCH, FFNAC, IFFSPC, IFFDT) 
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FFACC is s vsrible thst is obsolete since s Nusselc-sphere algorithm 
was incorporated into FFCAL for faster and store accurate calculation of form 
^actors where the node pairs are closely adjacent. It is recmsmended that 
.^FACC never be changed from its default value of 0.05. If improved accuracy 
is required^ selectively recompute the "problem" form factorsi using the 
NFFCAL program segment. With NFFCAL, accuracy is controlled by variable 
MELCT. (Reference Subroutine NFDATA). 

When node pairs are situated such that the interelement distances vary 
a great deal from point to point on the surfaces, it is more accurate to 
switch to the Nusselt-sphere calculation technique. When the ratio of the 
longest interelement distance divided by the shortest interelement distance 
exceeds FFKATL, the Nusselt-sphere technique is used. The default value for 
FFRATl. is 13. This generally yields good results but the user can increase 
accuracy by entering FFRATL values less than 15, and vice versa. Note that 
setting FFRATL to sero is equivalent to using the NFFCAL segment. 

The elemental breakdown of node pairs also influences form factor 
accuracy when shadowing by intervening surfaces is involved. For large 
magnitude form factors, the node pair element breakdown required to satisfy 
shadowing considerations is computed and used if it exceeds that dictated by 
separation distance (see Appendix B). If the unshadowed Form Factor in both 
directions is less than FFMIN the computations associated with form factor 
shading are by-passeo. The element count dictated by shadowing is inversely 
proportional to the parameter FFACCS. The default value for FFACCS (FFACCS > 
.1) was chosen based on experience. If the user knows chat one or more of his 
significant form factors will be heavily influenced by shadowing, the 
reconmended procedure is to selectively compute such form factors using a 
reduced value of FFACCS. 
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The peraneter FFMIN is used to reduce the bulk of the BCD Card output 
that results when a large form factor matrix is punched in form factor data 
block input format for re*‘use. The form factor in both directions must be 
less than FFMIN before it is discarded, (results in a 0.0 data value). 
Significant preprocessor time can be saved if the insignificant form factors 
are eliminated from the form factor data block. Determining what is 
insignificant may be a problem though. The default value, l.E-6 is 
sufficiently small that it does not materially affect the energy balance of 
most problems. 

The FFMOSU parameter has two options 4HSHAD, 4HN0SH. The program will 
default FFNOSH * 4HSHAD. If by-passing the shadow calculation is acceptable 
(program won't allow it for specular surfaces - see Section 3. 3. 3. 9. 2: Single 

Variable Input Format) FFNOSH * 4HN0SH will overide the Surface Data SHADE and 
BSHADE flags and will probably save considerable computer time. Consideration 
of shadowing, even when none acutally exists, is the most expensive aspect of 
the form factor computations. For checkout of the proper geometry, and active 
side inputs etc., it may be beneficial to make a short run with FFNOSH * 
4HN0SH, prior to a long run where shading is considered. 

FFNAC is the flag to eliminate the usual check of the 
currently-defined node number array against the node array on the restart (RSI) 
tape. This allows a user to make use of form factors computed for a different 
geometry. This will be of benefit only when the user knows the geometry 
change will not have any significant effect on the form factors being reused. 
(See Section 3.3.5: Form Factor Data). 
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IFFSPC la tha apaca noda nuabar if tha diraet calculation of tha form 
factor to apaca it datj^ad. If this arugmant it aaro, tha form factor to 
apaca it not calculated diractly and tha radiation to apaca ia obtained by 
aubtracting tha form factor aum from 1.0. Mote that if IFFSPC ia input, an 
arbitrarily large value for FFNIM may be uaad; thua eliminating radiant 
interchange of email aignificanca while retaining tha correct radiation sink 
to apace. 

For more information on this 

feature, refer to Appendix B, Section D. 

IFFDT is tha configuration name for access to form factors in the form 
factor data block. This parameter allows the use of the same set of form 
factor data block inputs for 2 or more configurations i.n the operations data. 
The default is the current configuration name. 

The remaining FFDATA parameters, FFPRMT, and FFPNCH are used to 
provide print and punch/tape output options. The tape option of FFPNCH will 
write Che Form Factor * Area products to the USERl tape with formatted writes 
acceptable to the Form Factor Data block (see Section 3.3.5: Form Factor 
Data). The USERl tape must be referenced in Che Option Data block and be 
actively assigned to the run. 
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Other variables that relate to FFCAL ana NFFCAL are IFFSHO, NFFSET and 
ITRC72» IFFSUO is used to control whether or not form factors to shadower-only 
nodes will be computed* The statement IFFSHO • NO prior to FFCAL or NFFCAL 
will bypass form factor calculations to the shadower-only nodes (see Section 
3*3*3*12: Shadower-only Surfaces). 

NFFSET directs the restart file (RSl/RSO) read/write operation in 
FFCAL and NFFCAL PER Table 4-1. For a given configuration, this controls 
whether only IR form factors are read and/or written, or whether both solar 
and IR form factors are read and/or written. 

ITRC72 is used prior to FFCAL or NFFCAL execution to list, 
concurrently with the form factors, all possible internode shadowers by node 
numbers. To activate this option, put the statement ITRC72 - 2H0N ahead of 
the FFCAL or NFFCAL execution* Possible shadowers for each form factor may 
also be printed independent of FFCAL or NFFCAL using subroutine PFFSHD. See 
section 4. 3. 3. 7 & Appendix D. 

4. 3. 3. 2 Subroutine NFDATA 

Calling sequence: GALL NFDATA (NELCT, FFNOSH, FFWIN, FFPRNT, FFPNCH, FFNAC, 

IFFSPC, IFFDT) 

NELCT provides user control over computation accuracy in the NFFCAL 
segment through control over tue number of elements used in form factor 
calculation* NELCT is the total number of elements allowed, divided between 
the i and j nodes according to their area* The allowable range is from 16 to 
700, with a default of 30. Regardless of NELCT, elements on surfaces of 
revolution are forced to subtend no more than 15 degrees of arc. For example, 
a 360 ^ cylindrical node will use at least 24 elements. The last seven 
arguments are id-»ntical to the corresponding arguments in FFDATA. See Section 
4.3. 3.1*: Subroutine FFDATA. 
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ITRC72 is used to obtain a list of possible Internode shadower or 
blocker nodes* See Para 4. 3. 3.1: Subroutine FFDATA, for additional 

inforaation. 

Table 4-1. Fonn Factor Control Content NFFSET 

NOTE: The variable "NFFSET" directs restart file read/write operations in the 

FF Link per the following table— 


NFFSET 


NO. OF NO. OF 

FF SETS FF SETS 

READ WRITTEN 


1 11 

(DEFAULT) 

2 11 

(SET BY USER) 

3 2 1 

(SET BY USER) 

4 2 2 

(SET BY USER 

OR BUILDC) 

NOTES: 1) The user defines NFFSET through a FORTRAN statement prior to 

FFCAL or NFFCAL executions. 

2) When semi-transparent surfaces are present, subroutine BUILDC 
sets NFFSET to 4. 

4. 3. 3. 3 Subroutine CHDATA 


Calling sequence: CALL CHDATA (NFIGFF, NFIGOO, NFFTYP, lAUTOC, FFPRNT) 

Before utilising the CMCAL Segment the user should refer to Section 
3.3.8: Correspondence Data to read the words of caution on the proper 
application of form factor combining. 
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NFIGPF end NFIGCO art configuration names. The CHCAL sefsent will 
retrieve fora factors (or iaage factors) stored under the naae MFIOFF » coabine 
thea by applying CORRESPONDENCE DRTA defined under configuration NFIGCO and 
store the resulting matrix under the current configuration name. Both these 
variables default to the current configuration naaei as defined on the most 
recent BUILD Card. NFFTYP alerts CHCAL to the type of fora factors to be 
found under NFI(7F. FF means ordinary fora factors. IF means iaage factors, 
as generated by the RBCAL or RTCAL segment. If lAUTOO is entered as NO, I 

polygons will remain uncoabined. FFPRNT is the print/no print flag for the 
combined form factors. FFPRNT defaults to YES. If CMDATA is not called, 

CHCAL proceeds on the basis of default values. 

4. 3. 3.4 Adiabatic ''Closure** Surfaces 


It is sometimes desirable to conserve energy in computing the IR 
radiation interchange factors in a thermal radiation problem that does not 
constitute a complete enclosure. The usual means of doing this is to complete 
the enclosure with an adiabatic reflector surface. This can be accomplished 
by entering a rudimentary closure surface in the surface data and using 
subroutine ADSURF to add the closure surface to the form factor matrix after 
form factors have been computed for the real surfaces in the problem. The 
ADSURF call should be followed by a GBDATA and a RKDATA or RCDATA call. An 
example of the application of this technique is shown in Appendix J. 

Subroutine ADSURF 


Calling sequence: CALL ADSURF (BCSN, NFIGFF, AREA) 

BCSN is the block coordinate system name und.r which the closure 
surface appears in the surface data. Only one side of the closure surface can 
be active. NFIGFF is the configuration name under which the new modified form 
factor matrix is to be stored. 
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Wh«n ADSURF is called, cha fora factor matrix is read under the 
current configuration naae, and fora factors from each node to the closure 
surface are coaputed by subtracting the fora-factor row stSM froa 1.0> This 
new row of fora factors is added to the fora factor matrix and the resulting 
aatrix is stored under the name given for NFXGFF. 

AREA is the area of the adiabatic closure surface. If desired, the 
area in square feet nay be entered as this argument. If it is more 
convenient, the closure surface can be defined with the correct diaensions in 
the surface data block and the area will thus be computed. To use the 
computed area, enter 0 (xero) for this argument. 

A subsequent CBDATA call must be SMde with the first and third 
arguments always as shown. CALL CBDATA (2HIR,6HNFIGFF,2HFF,0) 

4. 3. 3. 5 Subroutine RBDAXA 


Calling sequence: CALL RBDATA (NFIGFT, FFACC, FFACCS, FFRATL, FFPRMT) 

Subroutine RBDATA is used to define the paraaeters necessary to 
execute the RBCAL program segment that computes fora factors (also known as 
image factors) that include the one bounce effects of specular surfaces in the 
model. NFIGFF is the configuration name used by RBCAL to retrieve the 
ordinary fora factors previously computed by FFCAL and/or MFFCAL. NFIGFF 
defaults Co the current model naae. The remaining RBDATA parameters are Che 
same as defined under FFDATA and carry the same default values. If RBDATA is 
not called, RBCAL proceeds on the basis of default values. 
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4. 3. 3. 6 Subroutin* RTPATA 


Calling aaqutneaat CALL RTOATA (MELCT, FP1I08H, FFMXM, FFPINT, PFPNCB, FFMAC, 

N8AY, RAYMIM) 

KRAY is cha aquivalant total nuabar of rays origioatiog at aach noda 
with a diract viaw of a spacular~diffusa surfaca* The dafault valua is 10000« 

RAYMIN Is the fraction of original strangth that rays ara raducad to 
through suecassiva specular bounces bafora being neglected. Dafault is .001. 

Sea subroutine FFDATA for definition of raaaining arguaants. 

4. 3. 3. 7 Subroutine PPT3HD 

NOTE: Available in univac version only. 

Calling Sequence CALL PFFSHD 

This subroutine will provide a list of the potential shadowing nodes 
Chat will be considered for each node pair by FPCAL or NFPCAL when aaking fora 
factor calculations. This subroutine can be called whether or not FFCAL or 
NFFCAL is to be executed. The saae inforaation can be obtained concurrent 
with fora factor calculations through the control variable 1TRC72. See 
section 4. 3. 3.1, Subroutine FFDATA. 

4.3.4 Plot Package Subroutines 

4. 3.4.1 Subroutines NDATA, NDATAS 
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Callint ••qucnctst CALL NDATA (MV, VU, SCL, MACT, X8H0, S8LH, TIT» IIOTX, 

IXOTY, XKOTZ, lOTX, BOTY, ROTZ) 

CALL M&ATAS (MV, VU, SCL, MACT, I8B0) 

Ttica* call* ar* ua*8 to dafin* plot paraMtar* prior to axacuting tha 
NPLOT prograa aagBoat* A call to ooa of thaaa routfnaa prior to an N?LOT 
axacution 1* not aandatory, bacausa all arguaant* hava dafault valua* (raf. 
Appandix D). Tha variablaa dafinad by NSATA or NDATAS call* will hold for any 
*ub**quant NPLOT axacution in tha oparation* block. 

Tha MV paraaatar allow* tha uaar to tMka up to 6 MIMLTA or NDATAS 
call*, tharaby dafining up to 6 plot oparation*, bofora axaeuting NPLOT* Ona 
NPLOT axacution will exaeuto all tha plot oparation* dafinad. 

VU dafina* tha typa of plot daaired. Tha option* ara 3H3H>, IHX, IHY, 
IHZ, 3HALL, and 3H(XN. 3-D raault* in a 3-dittan*ional pictorial plot. X,Y, 

and Z produce orthographic projaction* of tha gaonetry a* *aen froa tha X, Y, 
and Z axa* of tha CCS, reapactivaly. ALL raault* in four fraaa*, 3-D, X, Y, 
and Z. GEN i* a ganaral 3-0 plot, where tha uaar ha* control of the 
orientation of tha CCS axa* relative to hi* point of view. 

SCL i* Che plot acala factor, defined by: 

SCL ■ length on plot frame/ length of aurfaca where 

length* of aurfaca* are a* defined in the *ur- 
face data block. 

The user ahould keep in mind that his hardcopy plot frame* are 
probably about 17.8 cm (7 inches) square. 
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NACT is th« flag that eoncrols nhathar or not aeciva si4a iadleatlag 
arroM appaar on cha plots. HACT dafaults to MO. If YB8 is antarad as this 
arguaant, arrows will ba shown. 

Shadow'only surfaeas (Saction 3.3.3.12t Shadowar-Ooly Surfaeas) ara 
not includad in tha noda plots unlass argiaant ISMO is antarad as YES. 

SELH is tha nam of tha array that contains a list of tha intagar noda 
identification ntiwbars tha user desires to plot salactivaly. Tha salactiva 
noda nuabar array is antarad in tha array data block. 

TIT is tha nsaa of tha Hollerith array containing any title the user 
desires on his plot fraaa. Up to 66 characters are allowed. 

IROTX, ISOTY, IROTZ, ROTE, SOTY, and gOTZ ara Cha group of six 
paraaetars defining point of view froa which the user will "see” his problea 
geoaetry in a general view. For ROTX, ROTY, and ROTZ identically sero, the 
central coordinate systea appears in plots as shown in Figure 4~1. 

ROTE is the rotation angle about E, Chat rotates the plot reference 
coordinate systea into tha Central Coordinate Systea, Y toward Z positive. 

ROTY is Che corresponding angle, about Y, Z Coward E is positive. ROTZ is tha 
corresponding anglu, about Z, E toward Y positive. 
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Figure 4~1 Nod* Plot Coordituitt Sy*t*a R*f«r«nc* 
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Using Figure 4-1 as the reference position, the user may arbitrarily 
relocate the axes by defining BOTX, ROTY and ROTZ to relocate the reference 
system so that it coincides with the desired systems location. The order of 
the rotations is defined using IROTX, IROTT, and IROTZ. 

4. 3.4. 2 Subroutines ODATA. ODATAS 


Cai:ing sequences: CALL ODATA (NV, VU, SCL, SCLR, RPLN, TRUEAN, 

TINEST, TIME, SELN, TIT, IROTX, IROTY, IROTZ, 

ROTX, ROTY, ROTZ) 

CALL ODATAS (NV, VU, SCL, SaR, RPLN, TRUEAN, 

TIMEST, TIME) 

These subroutines are functionally analogous to NDATA and NDATAS in 
relation to execution of the orbit plotter segment, OPLOT. 

NV is defined and functions identically with the similarly named 
parameter in NDATA. VU defines the plot type. Options are 3H3-D, 4HBETA, 
5HCIGMA, 3HSUN, 3HALL, and 3H(XN. 3H3-D results in a 3-dimensional pictorial 
plot of Che planet and spacecraft. 4HBETA results in an edge-on view of the 
orbit plane, with the BETA angle shown true. The 5HCIGMA view places the 
orbit plane in Che plot frame, as seen from north of the celestial equator. 
3HALL produces four frames, 3-D, CIGNA, BETA, and SUN. GEN results in a plot 
with the orbit coordinate system axes rotated according to user definition. 
SCL relates Che user's geometry dimensions Co plot scale according to: 

SFAC > SCL/OPMAX (NNS) 


where 
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SFAC is Che ebsoluCe surface scale factor (saae as SCL in NDATA). 

OPMAX (NNS) is Che maxima extension of any surface point from Che 

CCS origin (user surface data units). 

The user should generally enter a value of SCL equal Co about 1/2 Che 
desired planet radius in inches of plot frame. 

SCLR is Che distance from the planet center where Che user desires to 
see his CCS origin (in inches on plot frame). 

RPLAH is Che planet radius as plotted in inches. The planet radius 
default value used is 3.56 cm. (l.A inches). The default values for S(H. and 
SCLR are related to RPLAH according to the relationships: 

SCLR - 8.*RPLAN/7. 

SCL - (3.15 - SaR)/2. 

The user may note that his spacecraft's altitude, as it appears in the 
plots, is not related in any way to actual orbit altitude. This is because 
the primary reason for orbit plots is for visualization of orientation. Orbit 
radius is. however, available in common as the variable RTHET in the 
operations block. Therefore, if Che user cares to consider Che scaling 
involved, he suy write operations block logic to relate SCLR to actual orbit 
radius. 


TRUEAN is Che true anomaly at Che orbit point being defined for 
plotting (degrees from periapsis passage). Reference Figure 4-7: definition 

of True Anomaly, and Shadow EnCry/Exit Points. 
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TIIC is the tine at which the orbit point plot is desired, in hours 
(required only if TRUEAN is not defined). 

TUSST is time of periapsis passage, in hours (required only if TRUEAN 
is not defined). 

The remaining ODATA arguments, SELH, TIT, IROTX, IROTY, IROTZ, ROTX, 
ROTY, and ROTZ, are exactly analogous to the identically named NDATA arguments 
(ref. Section 4.3.4. 1: Subroutines NDATA, NDATaS). Figure 4-2: Orbit Plot 

Coordinate System Reference depicts the orbit coordinate system as plotted for 
ROTX ■ ROTY ■ ROTZ - 0. 
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Figure 4-2 Orbit Plot Coordinate System Reference 
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4.3i4.3 Subroutine PLOATA 


Celling sequence: CALL PLOATA (IPLUMT, IPLSN, IPLMA, PLCRVF, PLLABX, 

PLLABY, PLTITl, PLTZT2, PLXHPF, PLYKPF, PLCM&) 

This subroutine is used to define peraneters necessary to execute the 
output data plotter segpient PLOT. Refer to Appendix D: Subroutine PLOATA, for 
argument definitions. 

4.3.5 Direct Irradiation Subroutines 


The direct irradiation subroutines are used to spatially locate the 
spacecraft relative to energy sources. The various calls give the user the 
option of locating his spacecraft using classical orbit parameters, with a 
modified sun-referenced set of orbit parameters, with look angles, or with 
trajectory tape parameters. Subroutines are also available for defining 
spacecraft orientation spin rate, and the application of shadow tables. 

4. 3. 5.1 Subroutine ORBITl 


Calling sequence: CALL (»BIT1 (FRAME, ALAN, APER, OINC, TIMEST, HP, HA, 

SUNRA, SUNDEC, STRRA, STRDEC) 


or: 


CALL ORBITl (PHAME, ALAN, APER, OINC, TIMEST, HP, ECC, 
SUNRA, SUNDEC, STRRA, STRDEC) 

This subroutine defines an orbit using classic orbit parameters and 
locates the sun in the same celestial coordinate system referenced to the 
Vernal Equinox (reference Figures 4-3 and 4-4). 
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In Che cate of a star-oriented spacecraft, the star is located in the 
celestial coordinate systea, in the same manner as the sun. 
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ALAN - Longitude of ascending 
node measured from 
axis to line of nodes; 
positive toward 

APER - Argument of perifocus. 
measured in orbit 
plane in direction of S/C 
motion from ascending node 
to per laps is 


HP - Altitude at per laps is 

OINC - Orbit inclination (angle 
between X^-Y^, plane and 
orbit plane as seen from 
ascending node; 0. < OINC < 180 
(OINC>90^ for retrograde 
orbits) 


Figure 4-3 Orbit Definition in a Celestial Coordinate Systen. 
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Zc 



SUNRAy STRKA - Right ascension 
of siin/star; measured in X^^Yc 
plane from Xc axis; positive 
toward Yq axis; 0. Ra£. 360 


SUNDEC, STRDEC - Declination of 
sun/star; positive from X^-Yc 
plane toward Z^l -90 < I^C £ 90 


i 

Figure 4'-4 Sun end Star Locations in Celestial Coordinate System 
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PHAME !• a Hollerith imbm ua«d aa a flag to direct tha definition of the 
planet-dependent parametera. The allowable PHAME option# aret 3HMER, 3RVEM, 
3HEAR, 3HM00, 3HMAR, 3HJUP, 3HSAT, 3HHEP, 3HURA, and 3HSUM. Theae naaea aerve 
to define the following variablea which are aet by the ORBXTl or 0RB1T2 call. 
If the Uaer wanta to change any of the variablea they must be redefined to the 
new valuea after one of the ORBIT Subroutine Celia in the OPERATIONS DATA 
Block. 

PRAO - planet radiua 

SOL - aolar conatant at the average planet-aun diatance 

PALB - planet albedo value (aurface aolar reflectance) 

vn>S - infrared emiaaive power at planet aurface, dark aide 

WSS - infrared eaiiaaive power at planet aurface, aubaolar point 

GRAV - acceleration of gravity at planet aurface 

The valuea obtained froa the different planet naae arguaenta are 
tabulated in Table 4-II. Note that the valuea tabulated are in metric unita. 
The valuea atored in core, however, are in the TRASYS baae unita aytea, that 
ia, lenitth in feet, tiae in houra, energy in Britiah theraal unita. If the 
uaer deairea to manipulate theae quantitiea uaing hia own operationa block 
FWTRAN code, he would expect thea to be in the ft - hour - Btu unita. 

Note that only Mercury and the Earth* a moon are treated aa bodiea with 
nonunifora aurface teaperaturea . Thia ia correct for airleaa, alow-rotating 
planeta. For theae two bodiea, the eaiaaive power ia conaidered everywhere 
conatant on the dark aide. On the aunlit aide, the eaiaaive power reducea 
from the aubaolar value to the darkaide value at the terminator, according to 
a coaine law. 
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Tha user is cautioned that hia reaulta uaing PNAHE “ 3HMER aay ba 
axtraaaly nialeadlng. Thia planat'a accantric orbit, plua ita naarnata to tha 
aun, raaulCa in a aolar conatant variation of froM approxiaataly 6 to ovar 10 
Earth "auna” during tha Narcury yaar. Corraaponding variationa in tha 
aubaolar aniaaiva power occur* Tha recoaaendad procedure for FRAME “ 3HMER ia 
for tha uaar to properly define SOL and HSS according to hia knowledge of tha 
planat-aun diatanca. Thia ia dona uaing two F(MITRAN atataaanta ioBadiately 
following hia ORBITl call. Thia aoie technique ia available, of couraa, 
whenever tha uaar daairaa to change WD8, HSS, or SOL to valuaa other than tha 
built-in noainala. The uaar'c valuaa will hold until another ORBIT call ia 
encountered. 

ALAN, APER, OINC, HP, and HA are tha longitude of tha aacanding node, 
arguaant of parifocua, orbit inclination, and pariapaia and apoapaia 
altitudaa. Thaaa are tha five paraaatara nacaaaary to define an orbit in tha 
calaatial coordinate ayatem. The alternate ORBITl call allowa tha input of 
eccentricity (ECO in lieu of apoapaia altitude. TItCST ia the tine of 
pariapaia paaaaga, in houra. 

Tha angular aaaaureiaant arguaenta are in daciaMl degrees of arc. The 
altitudaa nuat ba apacifiad in feat. Note that FORTRAN allowa arithaetic 
operationa within a'guaant liata; thua tha following ORBITl call aight ba uaad 
where HP is known to ba 150 nautical ailaa: 

CALL ORBITl (3HEAR,32. ,90. ,22. 5,0. ,6080. «150. , .94,-41 ., 18. ,0. ,0. ) 

SUNRA and SUNDEC are tha ri^t ascension and declination of the sun, 
respectively, input in deciaal degrees of arc (Sea Figure 4-4). 

STXRA and STRDEC are the right ascension and declination, 
respectively, of a star for a star-oriented aiasion (see Figure 4-4). Zero or 
duaay arguaenta are passed for non-star-oriented aisaions. 

For heliocentric orbits, (FRAME - 3HSUN) ALAN, APER, OINC, SUNRA, and 
SUNDEC have no meaning and are passed as aero or duny argments. 
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Table 4-II Stored Planet Property Values 



Solar Constant Planet 


Planet at Mean Darkslde Subsolar Gravitational 

Radius Planet Distance Eailsslve Power Emissive Power Constant 



Mercury 2485. (8.153 E06) 0.058 8920. (2830) 0. (0.) 8402. (2666.) 3.513 (11.49) 

Venus 6199.(20.34 E06) 0.76 2570. (815.5) 154.2 (48.93) 154.2 (48.93) 8.462 (24.68) 

Kavth 6370.(20.90 E06) 0.30 1352. (429) 236.6 (75.08) 236.6 (75.08) 9.844 (32.20) 

Moon 1738. ( 5.702 E06) 0.047 1352. (429) 6.5 (2.060) 1288. (408.7) 1.622 (5.306) 

Mars 3314.(10.87 E06) 0.148 577.3 (183.2) 123.0 (39.03) 123.0 (39.03) 3.921 (12.83) 

Jupiter 69885.(229.3 E06) 0.51 49.6 (15.74) 6.1 (1.936) 6.1 (1.9J6) 26.04 (85.18) 

Saturn 57515.(188.7 E06) 0.50 14.7 (4.66) 1.8 (.5711) 1.8 (.5711) 11.17 (36.54) 

Uranus 25482.(83.61 E06) 0.66 3.65 (1.16) .31 (.0983) .31 (.0983) 11.52 (37.68) 

Neptune 24850.(81.53 E06) 0.62 1.48 (.47) .14 (.0444) .14 (.0444) 8.977 (29.36) 

Sun 698500.(2291. E06) — 6.262x10^ 6.262x10^ 273.8 (895.6) 

A 

Values stored in program are in ft. 

1*0 0 o 

Referenced to 1352 w/m (429 Btu/hr-ft ) at I AU. Values stored in program are in Btu/ft *hr. 

c 2 

Values stored in program are in Btu/hr-ft . 

^Values stored in program are in ft/hr»^ 
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4. 3. 5. 2 Subroutitw 0KBIT2 

Cilllnt t«qu«nc«tt CALL ORBIT2 (PMAME, CIGNA, BETA, CXGMA8, BETAS, 

TIHBST, HP, RA) 


or: 


CALL 0RBIT2 (PNAKC, C1Q:A, BETA, C1GNA8, BETAS, 

TXME8T, HP, ECC) 

Thin subroutine defines en orbit using sun*refereneed persaeters in 
the orbit eoordinete system. The orbit eoordinete system hes its X end T exes 
in the orbit plene end its Z exis completes e ri|^t*hended set. The 
spececreft trevels from X tomerds T. 

FRAME functions identicelly with ORBXTl. 

CICMA end BETA locete the soler vector in the orbit eoordinete system 
(see Figure 4*5). CXGMAS end BETAS locete e ster in the orbit eoordinete 
system (see Figure 4-5). Agein, these erguments ere sero or dummy for 
non-ster-orlented missions. 

For heliocentric orbits, (PHAMS ” 3HSUM) OSBXT2 is not epplieeble. 

4. 3. 5.3 Subroutine ORXEHT 

Celling sequence: CALL ORIENT (TYPE, XROTX, IROTY, IROTZ, BOTX, ROTY, ROTZ) 

This subroutine is used to define the spececreft orientetion rsletive 
to specc-environment heet sources. Orientetion is eccomplished by releting 
the spececreft ccntrel coordiiute system to e vehicle eoordinete system (VCS) 
thet remeins fixed, rsletive to e heet source or e ster reference. 
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tYPB £■ a Hollarich naaa uaad at a flag Co daflaa oriancation of Cha 
VC8. Allowabla optiona for TYPB ara 4HPU1I, 3R8UM, 4H81AR, or 4HTAPB. rifura 
4*-6 dapicca tha VC8 ralacionahip to cha haac aourcaa, acar rafaraoct, and 
orbit eoordinata tyactia for Cha PLAN» SUN, and STAR option. Tha Ry-«xia 
points CO Cha planat, sun, or star and Cha Z^-*xis is in Cha SMa half>spaca 

as Cha Z^.xxis. Tha Ty^axis lias in tha orbital plana and eoaplatas Cha 
right^handad sat. Tha TAPE option allows oriancation to ba dtfinad froa a 
trajaetory tapa. (Saa Saetion 3.3.9.3i TrajaeCory Taps Input) | 

An aabifuity axists for cha sun or star oriancad options whan tha sun 
of star vactor is parallal to Cha Z^-*xis. In this casa, tha T^-axis is 
dcflnad CO ba in cha diraction of Cha valoeicy vactor. 

IRTOX, IRTOY, IROTZ, ROTX, ROTY, and ROTZ ara Cha parsMtars nacassary 
Co locata cha spacacraft CCS ralativa to cha VCS into tha' CCS; it rotataa 
about X^.fxis, Yy toward Zy positive. ROTY is Cha saaa as ROTX, axcapC 
abouC Cha Z^-*xis, Xy toward Yy positive. 
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CICMA - Angle from axis to sun vector projection In 
Xo ' Yq plane. Measured CCW as seen from 
axis (In direction of S/C motion). 

0. < CIGMA < 360 

CICMAS - Same iS CI(^ except to star vector projection 

BETA - Angle from Zr, axis to sun vector 
0 ^ BETA ^ 180 

BETAS - Same as BETA, oxcept to star vector 


Figure A-5 Orbit Definition in Orbit Coordinate System 
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Orientation Example 

(CCS Z-axls locked to sun) ; 

TYPE - 3HSUN 



I8DTX - 1 
IROTY - 2 
IROTZ - 3 
ROTX - 0. 
RDTY - -270. 
RDTZ *900 


Rotates VCS into CCS, — ?7Qo 
about Y axis 

Rotates 90® about Z axis 


Figure 4-6 Vehicle Orientation with Subroutine ORIENT 
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IROTX, IROTY| end IROTZ control the order in which the rotations are 
perforaed. Integers 1, 2, and 3 are the allowed options. For example, IROTX 
■ 1, IROTZ • 2, and IROTY ■ 3 results in rotation first about X^^ then about 
Zy, and then about Y^. 

4. 3.5.4 Subroutines DIDTl and DITIS 


Calling sequences: CALL DIDTl (DINOSH, DIACC, DIACCS, TRUEAN, NSPFF, 

TIMEPR, DIPNCH, ISFAC) 


or: 


CALL DIDTIS (TRUEAN, NSPFF, TIMEPR, DIPNCH, ISFAC) 

These subroutines allow the user to define the form factor and 
shadowing accuracy parameters used in his direct irradiation calculations. 
Additionally, these routines can be used to update the spacecraft position in 
orbit by defining true anomaly (reference Figure 4-7). True anomaly can be 
defined directly or by defining a current time. 

DINOSH is a shadow/no shadow flag for direct irradiation 
calculations. DINOSH » 4HSHAD retains shadowing calculations. DINOSH ~ 
4HN0SH bypasses shadowing calculations. If by-passing the shadowing 
calculations is acceptable to the user DINOSH * 4HN0SH will overide the 
Surface Data SHADE and BSHADE flags and may save considerable computer time. 
Determining the existence of shadowing even when none actually exists is the 
most expensive aspect of the DI computations. For checkout of the proper 
orbit/orientation and active side inputs etc., it may be benef.'cial at times 
to make a short run with DINOSH * 4HN0SH prior to a long run where shading is 
considered. For the user faced with the need for a more in-depth 
understanding of the shadowing as it applies to a specific model the program 
has the optional feature of printing out for each DI computation the list of 
surface numbers it considered as possible shadowers when computing the direct 
solar flux. This is accomplished by adding in the Operations Data block 
ITRC71 ■ 2HON prior to the DI segment call. (This feature is available on the 
UNIVAC version only). 
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DIACC is the element selection eccurscy factor for node planet form 
factor calculations. Its function is similar to FFACC in form factor 
calculations and its default value is 0.25. (ref. Section 4. 3. 3.1: 
Subroutine FFDATA and Appendix B). 

DIACCS is the element selection accuracy factor for shadowing 
calculations (not applicable when DINOSH ■ 4HNOSH). Its function is similar 
to FFACCS in form factor calculations and its default value is 0.1. (ref. 
Section 4. 3. 3.1: Subroutine FFDATA and Appendix B). 
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TRDEAN is the true enonaly of the spacecraft aeasured in decimal 
degrees of arc from periapsis passage in direction of spacecraft motion. t 

TINBPR is used to define true anomaly in terms of time; TIMEPR is 
current time, in hours. If TIMEPR is defined, TRUEAM in decimal degrees is 
returned to the operations block in coamon. If TROEAM is defined, current 
time is returned to the* operations block under the variable name TIMEPR. 

NSPFF specifies a step number within which a planetary flux 
calculation was made. If the FORTRAN statement: PLTYPE “ 6HPLSAVE appears 



Figure 4-7 Definition of True Anomaly and Shadow Entry/Exit Points 
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prior to this cslculation, the fons factor matrix from the spacecraft to 
planet will be stored out of core under step NSPFF. If this form factor 
matrix is valid for additional orbit points vl*e.y circular orbit, planet 
oriented), the FORTRAN statement PLTYFE ■ 6HPLREAD is made in the first step 
subsequent to NSPFF. This will result in the planet form factor calculations 
being bypassed for the subsequent steps, with a corresponding saving in 
computer time. To reduce computation time for Restarts the Form Factor Matrix 
from the Spacecraft to the Planet is also saved on the RSO tape for circular 
Orbit-Planet oriented cases, when the CIRF option of the ORBGEN card is used 
(see Section 3. 3. 9. 2: ORBGEN Option). 

DIPNCH is the flag for punching direct irradiation data in the flux 
data block format. Options are 3HPUN, 2HNO, and 4HTAPE. The tape option will 
mrite the DI's to the USERl tape with formatted writes acceptable to the Flux 
Data block (see Section 3.3.7: Flux Data). USERl must be referenced in Option 
Data block and actively assigned to the run. 

ISFAC is the flag that controls whether or not flux shadow factors are 
written to the RSO tape for subsequent printing in the Direct Incident Link 
for restart runs. Enter NO to inhibit writing the shadow factors on the 
Univac version of TRASYS. Enter YES to write the shadow factors on the CDC 
version. 


Subroutine DIDTIS is a short form version of DlDTl to be used when the 
user does not desire to specify his accuracy and shadow/ no shadow flag. See 
Appendix D for DIDTl and DIDTIS argument default values. 

4. 3. 5. 5 Subroutines DIDT2 and DIDT2S 


Calling sequences: CALL DIDT2 (DINOSH, DIACC, DIACCS, NSPFF, SUNCL, 

SUNCO, PLa, PLCO, TIMPEPR, ALT, DIPNCH, ISFAC) 
or; 

CALL DIDT2S (NSPFF, SUNCL, SUNCO, PLCL, PLCO 
TIMEPR, ALT, DIPNCH, ISFAC) 
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These subroutines ere identical in function to DlDTl and DIDTIS in 
that they define the shadowing and accuracy parameters to be used in the 
subsequent direct flux segment executi<m, as well as furnish the parameters 
necessary to define the spacecraft's spatial relation with the sun and planet 
heat sources. 

The arguments DINOSH, DUCC, DIACCS, NSPFF and ISFAC are exactly as 
discussed in Section 4. 3. 5.4: Subroutines OIDTl and DIDTIS^ and tabulated in 
Appendix D. 

SUNCL, SUNOO, PLCL) and PLCO are the clock and cone angles needed to 
define the direction of the sun and planet position vectors in vehicle 
coordinate system S^space. Figure 4-8: Spacecraft Orientation with Subroutine 
DIDT2, shows how these parameters are defined. Their input units are decimal 
degrees of arc. 

ALT is the spacecraft altitude, above the planet, this argument must 
be input in feet. 

It should be noted that a DIDT2 call is not sufficient to define all 
the variables needed for a direct irradiation segment execution. In general, 
an ORBITl or 0EIBIT2 call must be made, or the variables PRAD, SOL, PALB, WDS, 
and WSS (ref. Section 4. 3. 5.1: Subroutine ORBITl) must be defined individually 
in operations block FORTRAN statements. The call to ORBITl or 0R3IT2 need 
only define PNAME. The remaining arguments may be dummys. 

The user should also be aware that spacecraft spin as defined by 
subroutine SPIN, is not applicable when DIDT2 or 0I0T2S are called, since 
0IDT2 and DIDT2S directly define spacecraft orientation as well as position in 
space. Similarly, the TYPE option in subroutine ORIENT is irrelevant when 
DIDT2 or DIDT2S are used since they fix the VCS axes arbitrarily in space. 
Subroutine ORIENT will, however define the relationship of the CCS to the 
VCS. If ORIENT is iWt called - Che normal mode of operation - the VCS and CCS 
will coincide. 
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Figure 4-8 Spacecraft Orientation with Subroutine DIDT2 


4. 3. 5. 6 Subroutine SPIN 


Calling sequence: CALL SPIN (CLOCK, CONE, RATE, TRUANS, SPNTM) 


Ravision 3 


This subroutine is used to define spacecraft spin. The erguaents 
CLOCK end CONE define the spin axis with reference to the central coordinate 
system. RATE defines the spacecraft spin rate about the spin axis in 
revolutions per hour. Figure 4**9: Spacecraft Spin Definition, illustrates the 
clock and cone angles, and the algebraic sign convention used with RATE. 

The tiae spin begins is defined through TRUANS or SPNTM. If the user 
knows the time his spin begins, he specifies it directly as SPNTM. If he 
knows the true anomaly where it begins he specifies TRUANS and passes zero for 
SPNTM. 


Spacecraft spin computations are done on the basis of the following: 
the spacecraft is asstased to be in the orientation defined by the last call to 
subroutine ORIENT at SPNIM. At any aubsequent points in time, the spacecraft 
is reoriented, presuming a constant spin-rate, about the SPIN-defined spin 
axis, over the time elapsed since SPNTM. 

The user should note a restriction when using subroutine SPIN in 
conjunction with the 0RB(3BN card: The only allowable ORB(XN options, after a 
call to SPIN, are PLAN and NOPL. This is because particular orientations are 
assumed by the CIRP and INER options that are obviously violated by spacecraft 
spin. SPIN is also incoispatable with trajectory tape options. 

4.3. 5. 7 Subroutine SPINAV 

NOTE: Not available in Univac version. 

Calling Sequence: CALL SPINAV (NSARY) 

This subroutine is used to compute the average incident and absorbed 
heat rates from a specified list of orbit points (stops) and place the result 
in current step data storage. The most coimaon use is to argue an array 
previously executed step numbers that correspond to a complete revolution of a 
spinning spacecraft. The argument is the name of an integer array of step 
numbers input in the Array Data Block. This series of step numbers must occur 
at aonotonically increasing points in time. 
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A tine weighted everege is performed end the result is stored under 
the current step number, with e time equal to the average of the times 
associated with each step in NSARY. This means that the HSARY set of steps 
‘it* first defined in the operations data block, then a separate step is 
defined containing a SPIHAV call, but not a DICAL execution. SPINAV uses 
cither DICAL or AQCAL data as input, or both. If the steps in NSARY contain 
only DICAL executions, an AQCAL execution must follow the SPINAV call within 
the same step. If each NSARY step contains an AQCAL execution, another AQCAL 
call is superfluous and will cause an abort. 

4. 3. 5.8 Subroutine DICPMP 

Calling sequence! CALL DIOOMP (ISOLFL, lALBFL, IPLAFL) 

This subroutine allows the user to define the logic used in a 

subsequent DICAL execution. The choice of computing, stuffing from another 

step, or zeroing out individual solar, albedo, and planetary fluxes is 
available. See Appendix D: Subroutine DIOOHP, for argument definitions. 

4. 3. 5.9 Subroutine DISTAB 

Calling Sequence! talL DISTABCTOLS, TOLP, NSAR, NPAR, ISFL, IPPL) 

This Subroutine allows the user Co control all aspects of Che way 

shadow factor Cables are used in the calculation of solar, albedo and 
planetary fluxes. Enter zero for default action. 

TOLS is Che tolerance used when interpolating the shadow factor Cables 
for solar flux calculations. When the difference between Che adjacent shadow 
table values being interpolated is greater Chan TOLS, Che interpolation is 
abandoned and an analytic shadow factor is computed. Default value is 0.5. 
TOLP is analagouj to TOLS in albedo and planetary flux calculations. Default 
is 0.75. 


NSAR is the name of an array of node numbers for which solar flux 
shadow factors will always be calculated rather than interpolated from the 
Cables. NPAR functions Che same for albedo and planetary fluxes. 
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If ISFL it entered et W), toler flux thedow fectort will not be 
obtained froii the thedow tablet for any nodet. If YES» NSAR and TOLS control 
the decitiona. IPFL functiont the aeae for albedo and planetary flux 
calculatioua. 

NOTE: DISTAB «utt be called tubtequent to an SPCAL execution and prior to the 

DICAL executione to be affected. If not called, default valuea are uted. 

4.3.5.10 Subroutine DITTP and DITTPS 


NOTE: Thete tubroutinet are obaolete for ute on the Univac vertion. Intcead, 

tee Section 3. 3. 9. 3, Trajectory Tape Input. 

Calling tequencet: CALL DITTP (TIME, ITYPE, PLANAM, IDHDM, FIDEN, NTIM, 

NTYPE, NCLPL, NCOPL, MCLS, NCOS, NRAD, NWOR, ALTMF, 

IBOD, DIPNCH) 


or: 


CALL DITTPS (TIME, ITYPE) 

Thete tubroutinet allow the uter to define hit aittion by reading 
trajectory tapet of the attitude timeline variety. The pertinent data are 
read from the tape and placed in ttorage for ute by the DICAL aegpent through 
an internal call to DI0T2. 

Subroutine DITTP allowa the uter to define Che trajectory tape format, 
identify the proper file cm multifile tapet, define the attitude parametert 
for hit firtC compute point, and potition Ch^ tape for reading tubtequent 
points. Subsequent points are read using DITTPS, which presimies chat the Cape 
is previously positioned Co Che correct file, and a call to DITTPS results in 
repeated reads of trajectory Cape records until a time value equal Co TIME is 
encountered. If ITYPE is defined (as an integer data value), repeated reads 
are made until TIME is encountered, then reading continues until a special 
event identifier equal to ITYPE is encountered. Note that this tape reading 
method precludes calling for a tiaw value less than the time argument used in 
a previous DITTP or DITTPS call. 
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- Rotational Axis 


)te ; Spin axis coordinates Illustrated for the 
case clock ■ 180, cone • 90 


Figure 4-9 Spacecraft Spin Definition 
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Figurt 4*10 is an opsrstions data block sagBiant that t*°*r>caa diract 
irradiation for thraa tiM pointa» using a trajaetory tape. In Stap 2, tha 
trajactory taps is positioned to a fils naaad ZLVl and tha >iata ara read at 
TIKE ■ 10.0 hours, which is not a spacial avant point. Tha planat involvad it 
Earth, flux output is punched, and tha spacecraft altitude data on tha tape 
are in nautical ailas (ALTMF ■ 6080.). Trajactory tape foraat ii^foraation is 
as follows: 

a) Tape records ara 38 words long (NMOR • 58). 

b) Tape is for I body (IBOD - 0). 

c) File identification is found in word 1 of tape records 
(IDWDH - 1). 

d) Tiaa is found in word 3 of tape records (NTIM ■ 3). 

a) Special event identifier is found in word 5 of tape records 
(IITYPE - 5). 

f) Planet center-to^spacecraft distance is found in word 13 of tape records 
(NRAD - 13). 

g) Clock angle-to-planet vector is found in word 9, (MCLFL “ 9). 

h) Cone angle-to-planet vector is found in word 10, (MCOPL ■ 10). 

i) Clock angle-to-sun vector is found In word 11, (NCLS * 11). 

j) Cone angle-to-sun vector is found in word 12, (NCOS “ 12). 

Step 2 reads trajectory tape infonaation at tiaa ■ 10.5 hours, which 
is not a special event. Step 3 reads trajectory tape inforsation at a special 
event of type 2, which occurs just subsequent to 11.0 hours. 
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HEAISR OPERATION? DATA 
STEP 1 

CALL BOILDC (ALLBLR.O) 

L FPCAL 

L GBCAL 

STEP 2 

CALL DITTP(10.0,0,3HBAR,1,4HZLV1,3,5,9,10,11,12,13,S8,6C80.,0, 
13HPUN) 

L DXCAL 

STEP 3 

CALL DITTPS(10.5,0) 

L DICAL 

STEP 4 

CALL DITTPS(11.0,2) 

L DICAL 


Figure 4*>10 Trejectory Tepe Operetions Exaaple 


4.3.5.11 Subroutine DRDATA 


CalUr.« •equrr'.cc*: CALL DRDATA (MSTPDI, DIACCS) 

This subroutine defines the psrsaietcrt necessary to execute the MICAL 
progrsa segpent. NSTPOI is the step masber that DRCAL will use for retrieving 
the direct solar fluxes coaputsd by DICAL. DRCAL computes the solar 
irradiation resulting from o;ie specular bounce* This specular reflection is 
added to the direct solar flux and the result is stored under the current step 
numbttr. The diffuse component of the reflected energy is added to the total 
absorbed heat data later in an AQCAL execution, as in purely diffuse models. 
DIACCS is the shadowing accuracy parameter. (Reference DIOTl) N8TDPI 
defaults to the current step number and DIACCS defaults to 0.1. Default 
values are used by DRCAL if no call is made to DRDATA. 
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4.3.6 Kadiation lotwfchjng* 8utroutlo«« 

4. 3. 6.1 Subtowtint CIPATA 

C«llitit ••qucnect CALL GBDATA (CaUBHD, 6BMriCrr» NFFTYP ) 

This subrcutins dsfiass ths parsastsrs nscssssry prior to sxocutiag 
ths CBCAL to obtain a graybody factor aatrix. 

Argiaant CBWBMD (Optional 3R80Ly 2HXt« 4HB0TB) dafittas the anargy 
wave band— solar f infrarad, or both— that will ba usad in gray^body factor 
calculation. 

Arguaant MTIGFT is tha configuration Aa»s undar which tha fora factor 
aatrix dasirad for gray body calculations is storad. Dafaults to currant 
configuration naaa. 

Arguaant HFFTYP is the type of fora factors stored undar NFICFF. FT 
for ordinary fora factors, CM for coabinad fora factors, and IP for iaaga 
factors. 


4. 3. 6. 2 Approxiaata Itadiant Intarchanae Factors - Subroutine CBAPEX 

A routine is svailabla in tha processor library that coaputes 
dif fuse^gray-body interchange factors according to th« first-order 
approx inationi 


3 . . ■ P10PI*PB0PJ*P. . 
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where 


PROPl and PROPJ are the diffuse surface properties, solar absorptivity 
or infrared enissivity; 7 • j is the approxiaate radiant interchange factor be- 
surfaces i and j; 7.j is the form factor. This equation is, of course, 
exact for a black enclosure (PROPl * PROPJ • 1 for all i, j). 


A call to subroutine GBAPRX in lieu of executing the 6BCAL segment will 
generate the approximate gray-body factor data and store then in the same 
manner as (T- vAL. This approach is theoretically correct when there are no 
reflections e.g., surfaces are black). The greatest er >r is for a complete 
enclosure with very low emittances. The error will be reduced as a 
configuration becomes more "open” and the emittances become higher. In 
general the application of this routine will be for very special cases. 

Calling sequence; CALL GBAPRX (GBWBND, 6HNFIGFF, NFFTYP) 

This subroutine calculates gray-body radiant interchange factors using the 
approximate relationship described above and stores the results in data 
storage under the current configuration name. 


Argument Name Description 

GBWBND Waveband definition 

name 

NFIGFF Configuration name for 

form factor access 

NFFTYP Form factor type to 

be used in GB calcu- 
lations 

Note: Input zero fur default action. 


Options Default 

2HIR, 3HS0L 4HB0TH 

4HBOTH 

Current Config. 
Name 

2HFF, 2HCM Last type cal- 

culated under 
NFIGFF 
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4. 3.6.3 Subroutine RKDATA 

Calling sequence: CALL RKDATA (MFIGGB, SKPKCH, RXHIN, IHKCH, RKSP» 

IRKNSP, SIGMA, RKAMPF, RRTAPE, HFIGCO) 

This subroutine defines the parameters necessary prior to executing 
the RKCAL program segaent to obtain radiation conductors (RADRs) in thermal 
analyzer format. The radiation conductors are not stored on the RSO tape. 

The computer charges for computing the radiation conductors when ZR gray*-body 
factors are known is minimal. 

Arguaienc HF1G6B identifies the configuration name under which the 
desired IR gray-body factor matrix can be accessed for computation of the 
desired radiation conductors. 

Argument RKPNCH (Options: 3HPUN, 2HN0) is the punch/no punch flag for 
radiation conductors on BCD card format. 

Argument RKMIN defines the lower limit of the radiation conductor 
values that will be punched or put on the BCDOU tape. The way the heat 
balance is written in most thermal analyzers is the energy exchange for those 
connections dropped out will be lumped back into node i. The radiation 
conductor to a space node is never dropped out unless 0.0. RKMIN is defined 
as follows for a valid radiation conductor: 

'3ijAi/«iAi< RKMIN 

where 

3.. is the gray-body factor from node i to j, 
is the infrared cnsittance of node i. 

Argument IRKCN is the initial radiation conductor identification 
number. The radiation conductors are numbered consecutively from IRKCN. 

They can range from 1 to 6 digits. 

Arguments RKSP and IRKNSP provide the information to define radiation 
conductors to space for problems that do not form a complete enclosure. RKS? 
(Options: 5HSPACE, 2HNO) flags the output of radiation conductors 
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to space. When RKSP * 5HSPAC£» radiation conductors to space tor node i are 
computed according to 

N 

*A. A . . 7 ij * A.) 

'^i-space 1 11 ^ 1 

J 

for an N-node problem* IRRNSP is the user-defined identification number for 
his space node. An exception to this is when the form factors to space are 
calculated directly by FFX^AL or NPPCAL. In this case the radiation conductors 
to space are found in the GBCAL data file and are simply printed and punched 
out directly by the radiation conductor segments. 

SIGMA and RKAMPF are available for the user to obtain unit agreement 
between his radiation model and thermal analyzer model. SIGMA is the 
Stefan-Boltzmann constant that will appear on the radiation conductor and 
RKAMPF is an arbitrary multiplication factor available to change from the 
TRASYS standard area units (square feet) to the area unit the user desires. 

If RKAMPF is l.O, the area unit associated with SIGMA must be square feet. 

Argument RKTAPE (Options: 4HTAPE, 2HN0) allows the user to write his 

radiation conductors to the BCDOU tape in a thermal analyzer format. 

Argument WFIGCO is the configuration name for correspondence data access. 

All RKDATA arguments have default values (see Appendix D) so that an 
RKDATA call before an RKCAL execution is not mandatory. 

4. 3. 6.4 Radiation Condenser - Subroutine RCDATA 


The radiation condenser segment provides the user with two methods of 
radiation model simplification. 

The first of these methods, which is referred to as the Multiple 
Enclosure Simplification Shield (MESS) technique, allows a complex radiation 
enclosure to be modularized into discrete sub-enclosures by the assignment of 
imaginary interface shield nodes. Each of these smaller enclosures can be 
analyzed independently of the others, resulting in more efficient use of 
computers and manpower. 
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The second method, referred Co as the Effective Radiation Node (ERN) 
technique, is used to reduce the number of radiation couplings required to 
thermally model an enclosure by replacing small conductors from each node with 
a single conductor coupled to the enclosure ERN. 

The techniques and their application are described in more detail in 
Appendix F. 

Calling sequence: CALL RCDATA (NFIGGB, RKPNCH. RKMIN, IRKCN. RKSP. IRKNSP. 

SIGMA, RKAMPF, RKTAPE, NFIGCO, RFRAC, RTOL, NERN, IPRIME, 
ISECND) 


This is a user-called subroutine that defines the parameters used in 
RCCAL for the condensation and output of radiation conductors (RADKs). 


Variable 

Description 

Default Value 

NFIGCB 

Configuration name for IR gray-body factor 
access 

Current config 
name 

RKPNCH 

Punch/No Punch Flag. Options: 3HPUN, 

2HN0 

3HPUN 

RKMIN 

Minimun Value of Aj/Aj^ ^ 

that will result in a valid RADK. 

For ERN couplings, if NERN is positive 
the RKMIN test is applied to the sum 
of those connections discarded after 
the RFRAC requirement is satisfied. 

0.0001 

IRKCN 

Initial Radiation Conductor Number 
(Conductor numbers may range from 1 to 
6 digits) 

1 

RKSP 

Flag for output of RADKs to Space 
See Section 4. 3. 6. 3: Subroutine RKDATA 
Options: 5HSPACE, 2HN0 

2HN0 

IRKNSP 

Space Node Number 

32767 

SIGMA 

Stefan-Boltzmann Constant 

1.713E-9 

RKAMPF 

Area Multiplying Factor 

l.O 

RKTAPE 

Flag to write RADKs to BCDOU Tape. 
Options: 4HTAPE. 2HN0 

2HN0 
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NFIGCO 


Configuration name for Correspondence 
data access 


Current Config* 
name 


RFRAC Significant Radiation Fraction: Radiation None 

conductors of a node to be left intact 
divided by the sum of the node’s conductors* 

Ref. Appendix P, Equation 6. 

RTOL Percentage of SLAST (last conductor .99 

saved to meet RFRAC criterion). Subse- 
quent conductors are saved if their values 
are greater than RTOL*SLAST. 

NERN Effective Radiation Node (ERN) Number* None 

Any negative value will cause the pro- 
gram to print all ERN conductors but 
not punch or write them to tape. 

IPRIME Array Name for Array of Primary MESS None 

Node Numbers and Special Node Numbers. 

ISECND Array Name for Array of Secondary MESS None 

Node Numbers. 


In the printout for both the RK and RC segment, after all the card 


images of the radiation conductors are listed, the program prints out two 
summary tables. The first table is a conservation check of each node in the 


model with any correspondence data applied before the number of radiation 


couplings are reduced in these segments. The value printed for each node 


is 



£ j Ax / Ai 


i. 


For a complete enclosure theoretically it should be 


l.O. If there is a space node it should also be l.O. The second summary 
table is the conservation check made after Che number of radiation couplings 
have been reduced. These two tables can be very helpful in finding input 
errors, and in evaluating the effects of radiation coupling reduction 
techniques. 


Restrictions : 


1. RCDATA must be called prior to RCCAL execution because all of the 

variables are not defaulted. 
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IPRIME and ISECND arrays Bust be Input In the array data block (see 
Section 3.3.2: Quanitles and Array Data Blocks) to specify MESS node 

pairs and special nodes. IPRIME contaios a list of all priaary MESS 
nodes and all special nodes in that order. Special nodes are nodes 
that are excluded from being connected to the ERN. ISECND contains 
a list of all secondary MESS nodes in a one-to-one correspondence 
with the primary MESS nodes in IPRIME. 

Each MESS subenclosure is a separate configuration, thus each one 
requires a call to RCDATA and a RCCAL execution. Primary nodes are 
actually part of the configuration while secondary nodes are not. 

The secondary nodes are primary nodes when RCDATA is called for the 
neighboring subenclosures. When the MESS technique is used, the 
total of all the RADKs generated by several RCCAL executions comprise 
part of a single thermal analyzer model. 
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4.3.7 Absorbed Hest Subroutines 


4. 3. 7. I Subroutine AQDATA 

Calling sequence; CALL AQDATA (lAQGBI, lAQGBS, RSOLAR, RALB» RPLAN» NFIGCO) 

This subroutine defines the parameters necessary prior to executing 
the AQOl. program segment to compute absorbed heats. 

lAQGBI (Options CONFN, F2ER0I) CONFN is the Hollerith configuration 
name in effect when the appropriate infrared grey-body factors were computed. 
FZEROI is the zero flag for infrared absorbed heat. When lAQGBI ■ 4HZER0» all 
infrared absorbed fluxes will be zero, and no infrared grey-body factor matrix 
is needed for AQCAL execution. 

lAQGBS (Options CONFN, FZEROS) is analogous to lAQGBI for the solar 
waveband. 


RSOLAR is a solar-heat rate multiplying factor (defaults to 1.0). 

NOTE: Albedo heat rates are multiplied by R solar also. 

RALB is an albedo-heat-rate multiplying factor (defaults to l.O). 

RPLAN is a planetary-heat-rate multiplying factor (defaults to l.O). 

NFIGCO is the Hollerith configuration name for correspondence data. 

Configuration name arguments will default to the current configuration 
name, so that an AQDATA call is not required if all necessary data are in 
storage under the current configuration name. 

Variable AQPRNT controls whether or not a detailed printout of 
absorbed heat data is obtained. Detailed prints consist of the direct and 
reflected components of the absorbed solar, albedo and planetary heat rates 
with applicable correspondence applied. To activate this print, enter the 
FORTRAN statement AQPRNT » YES prior to any ORBGEN card or L AQCAL card. 
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Without AQPRNT the ebsorbed Q veluee do not get printed. The nomel printout 
only informe the user thet they heve been cosq>uted. The absorbed hast output 
segment (QOCAL) is the normal means by which the user obtains s printout of 
the total ebsorbed heating rate (see Section 4. 3. 7. 3: Subroutine QODATA). 

Although the AQ data values ere written to the RSO tape, they are 
never utilized by e restart run. They are written to the RSO tape (as is 
other data in this category) to be used by other interface programs. The 
computational charges for the AQ and QO segments are very minimal once the 
direct incident and gray body factors are known. 

4. 3. 7. 2 Subroutine STFAQ 


Calling sequence: CALL STFAQ (TRUEAN, TIMEPR, NSTP) 

This subroutine stuffs values of absorbed heat and/or direct flux 
computed in a previously executed step into out-of-core storage for the 
current step. It also stores time for the current step, defined either 
directly or from true anomaly. 

The argument NSTP is the step number from which the desired absorbed 
heat values will be obtained. 

The geometry, as defired by BUILDC and ADD calls, in effect at the 
time any STFAQ call is made must agree exactly with that in effect when step 
NSTP was executed. 

4.3. 7.3 Subroutine QODATA 

Calling sequence: CALL QODATA (NSARRY, NTMARY, QOTAPE, QOPNCH, QOAMPF, 

QOFMPF, QOTMPF, QOTYPE, NFIGCO) 

This subroutine defines the parameters necessary to allow absorbed 
heat data in thermal analyzer format to be generated in a subsequent QOCAL 
execut ion. 
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Argument NSARRY is Che neme of en errsy concsining Che previously 
executed step numbers where the desired ebsorbed-hesC decs cen be found in 
scorsge. The Step Numbers in the errsy do not hsve to be in numeriesl or 
chronologiesl order for the progrsm to work correctly. Unless NSARRY ■ 3HALL, 
this errsy must be entered in the errsy decs block. The user is referred to 
Section 3. 3. 2. 2.: Quentities end Arrsy Dete Block, for exemples of weys this 
errsy mey be defined. If the 3HALL option is used, Che step numbers do not 
hsve to be listed in en errsy by Che user. All ebsorbed best decs computed 
since Che lest cell to QOINIT will be output. 

Argument NTMARY is Che chermel enelyeer errsy number the user desires 
for his time stray when Q vs time cables are being generated. The Q arrays 
generated will be numbered consecutively from N'TMARY'^l. 

Arguments QOTAPE and QOPNCH are flags to control Che form of Q table 
output. Options are 4HTAPE, 2HN0 for write/no write Co Che BCDOU Cape, and 
3HPUN, 2HN0 for punch/no puich control. 

Arguments QOAMPF, QOFMPF and QOTMPF are f.be multiplying factors for 
area, energy, and time, respectively. The defeuli. values of l.O result in 
time in hours, area in square feet, and energy ir BCu/hr. 

Argument QOTYPE controls the type of out >uc obtained. 3HTAB results 
in Q vs time tables; 2HAV results in an integrated average Q for the time 
period defined by NSARRY. 

NFIGCO is the Hollerith configuration rame for correspondence data. 

4. 3. 7.4 Subroutine QOINIT 
Calling sequence: CALL QOINIT 

This subroutine rewinds the file containing the absorbed Q data, thus 
providing user control of the number of time points obtained with NSARRY ■ 
3HALL. 
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4.3.8 Data Modification Routinaa 


A aariaa of routinaa ara availabla chat anabla the uaar to ehanga 
cartain typaa of data from Cha oparationa data block. Thia providaa a 
convaniant way to perform many typaa of paramatric atudiaa without cha 
nacaaaiCy of making mulclpla **000 and arror^prona changaa to Cha aurfaea 
data. If "MOO" aubroucinaa ara uaad and chan a naw configuration ia "built" 
cha initial condiciona paaaad from tha praprocaaaor to cha procaaaor will 
ovarrida the previoua MOO aubroutina cal la. 

The aariaa of routinaa allowa Cha following noda praparciaa to be 

changed: 

a) Area; 

b) Oiffuae infrared amiaaivicy and/or aolar abaorptivity; 

c) Specular infrared and/or solar reflectivity; 

d) Infrared and/or solar transmisaiviciea; 

e) SHAOE/BSHADE flags. 

Calling sequences are designed so that the properties may be changed for one 
or all active nodes with one call. The use and function of these routines is 
explained in c'le following sections. 

4. 3. 8.1 Subroutine MOOAR 


Calling sequence: CALL MOCAJt (NO, AR) 

This subroutine changes the area of a designated node or the area of 
all currently active nodes by use of a multiplier, for utilization in the 
radiation conductor and QO segments. 

If this subroutine is misused it may give erroneous results. The 
intended and only valid application of this subroutine is very limited. If a 
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node always has cha same number and distribution of alaisants, and the same 
elements are always shadowed in the FP and DI sagiaants the MODAR approach is 
correct. In TRASYS, though the nund>er of elements are seldom constant. If the 
number, however, is always large the error may be minimised. In general it is 
recommended that the MODAR subroutine be used only whan a specific area of 
this node is always shadowed, and when tnera is always a sufficient eleswnt 
breakdown to closely define the boundaries of the shadow. The MODAR* s do not 
affect the form factor * area, the script P * area matrices, or the 01* s. 

MODAR does effect the radiation screening process, the radiation conductor 
value to space, and the absorbed heating rates in the QO segment. 


Argument Name 

Description 

Options Default 

ND 

Node Number 

a) 

Any Active 

None 


Designator 


Node Number 





(Integer). 




b) 

SHALL 


AR 

Desired Value 

a) 

Floating- 

None 


for Area 


Point Data 





Value 




b) 

Area Multi- 





plier^ (3HALL 
Option Only) 



Note ; 1. When ND ■ 3HALL, all active node areas are modified according to 
AREA « AREA^AR. 

Restriction: Call not valid prior to geometry definiciot. through 

calls to BUILDC and ADD. 
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4. 3. 8. 2 Subroutine HODPR 


Celling sequence: CALL HODPR (ND, ALPHA, BMISS) 

This subroutine modifies the diffuse infrsred emissivity snd/or the diffuse 
solsr sbsorptivity of s designetsd node. 


Argument Naas 

Description 

Options 

Default 

ND 

Nodt Number 

Any Active 

None 


Designecor 

Node Number 


ALPHA 

Diffuse Soler 

s) 

0.^ DV^ 1. 

None 


Abtorpcivlcy 

b) 

DV < 0. 


EMISS 

Diffuse IR 

s) 

0.^ DV ^ 1. 

None 


Emissivity 

b) 

DV < 0. 



Note : 1. If ALPHA < 0. or EMISS < 0., current vslues ere not ehsnged. 

2. Property chsnges effect entire surf see. 

Restriction: Cell not velid prior to geometry definition through cells 

to BUILDC end ADO. 

4. 3. 8. 3 Subroutine MOOTR 


Calling sequence: CALL MODTR (ISR, TRANS. IRANI) 

This subroutine modifies the solsr snd/or infrsred trsnsmissivity of s 
designsted surfsce. 
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Arguatn-' Naat 

DtacripCion 

OpC Iona 

DtfaulC 

ISR 

Surfact Nuabtr 

Any Accivt 

Nona 


DtaignaCor 

Surfact Nuabtr 


TRANS 

Solar Trana- 

a) 

0. fa DV < 1. 

Nont 


aiaaivicy 

b) 

DV < 0. 


TRANI 

IR Tranaaia- 

a) 

0.^ DV < 1. 

Nont 


aivicy 

b) 

DV < 0. 



Nof ! 1. TRANI and TRANS valuta laaa Chan aero art uatd Co eorrtccly accounc 
for cht cranaaiaaivlcy of doublt~factd aurfaeta tnctrtd atparactly> 

A ntgacivt valut ta not rtquirtd whtn Cht ACTIVE • BOTH opcion la uatd 
Ln cht Surfact Daca block btcauat only oot aurfaet ia conaldtrtd co 
ahadow tvtn if boch aidta art accivt (Ktftrtnct StcCion 3. 3. 3. 8: 
Proptrciea Daca) . 

2. Tran.^aiaaivicy changta afftcC Cht tncirt aurfaet. 

ReaCriccion: Call noc valid prior co gtoatcry dtfinicion chrough ealla cu 

BUILDC and ADD. 

4. 3. 8. 4 SubrouCint MODPRS 

Calling aequenct: CALL MODPRS (ND, SPRS, SPRI) 

Thia aubroucine aoctifiea Che aolar and/or Infrared apecular 
reflecCiviCy of. a deaignaced node. 
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Artumenc Nme 

Description 

Options 

Default 

ND 

Node Number 

Any Active 

None 


Designator 

Node Number 


SPRS 

Specular Reflec- 

a) 0. ^ DV ^ 1. 

None 


tivity, Solar 

b) DV < 0. 


SPRl 

Specular Reflec- 

a) 0. ^ DV ^ I. 

None 


tivity, Infrared 

b) DV < 0. 



Nof 1. If SPRKO. or SPRS<0., current values ere net changed. 

Restrictions: 1. This call is applicable only to nodes defined as specular 

reflectors in the surface data block. 

2. Call not valid prior to geometry definition through calls 
to BUI LOG and ADD. 

4. 3. 8. 5 Subroutine MODSHD 


Calling sequence: CALL MODSHD (ISR, SHADE. BSHAOE) 

This subroutine modifies the SHADE/BSHADB flags for a designated 
surface. 
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Argument Name Description 


Opti 


ion 


Default 


ISR 


SHADE 


BSHADE 


Surface Number 
Designator 
Can Shade Flag 


Any Active 
Surface Numoer 
FF, DI, BOTH, 

1 


NO, 0 

Can Be Shaded Flag FF, DI, BOTH, 

NO, 0^ 


None 


None 


None 


NOTE: 


I- If SHADE or BSHADE data values are. zero, their values are 
not changed. 


2. Shade flag changes affect the entire surface. 

Restrictions: I. Call not valid prior to geometry definition through 

calls to BUILDC and ADD. 


2. Call not applicable to shadower^only surfaces. 


4.3. S.6 Subroutine NQDDAT 
Calling sequence: CALL NODDAT 

After a series of calls to the "MOD** routines, it might be 
desirable to obtain a printout of the nodal properties as a check. NODDAT 
provides this feature. A call to NODDAT anywhere in the operations data block 
will produce a printout of the optical properties assigned to each currently 
active node. 


4,3.9 Restart Control Subroutines 


Two routines are available in the processor library for u.^e in 
stopping or resuming the reading of a Permanent Restart Input (RSI) tape 
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during ■ rtstarc run. The judicious use of RSTOPF end RSTON allows Che user 
Co inserC new segnenc calls, delece segmenC calls or redo any pare of Che 
operacions daCa. (Refer Co SecCion 3. 3. 9. 7: Rescarc Operacions) 

4. 3. 9. I Sub roue ine RSTOFF 


Calling sequence: CALL RSTOFF 

A call CO chis rouCine scops Che reading of daCa from Che RSI 
file and inicisces Che processing of Che operacion daCa logic following Che 
call. 


4. 3. 9. 2 SubrouCine RSTON 


Calling sequence: Call RSTON 

A call CO Chis rouCine sCops processing of operacions daca 
logic and causes Che resumpcion of Che reading of daca from Che RSI file. 

4. 3.9. 3 SubrouCine RSMERG 


Calling Sequence: CALL RSMERG (NUNIT, MODLER, INCRM, IFLAG, lEND) 


Argumenc Name 

Description 

Options 

Default 

NUNIT 

Name of restart 
to be read 

RSI, EMERG, 
RSI2 

None 

MODLER 

Configuration name 
on NUNIT pseudo-file 
desired 

Any config. 
name 

None 

INCRM 

Node number increment/ 
decrement to make node 
array on NUNIT agree 
with current node array 

Inceger number 

0 

IFLAG 

Flag to recompute 
shadower-only form 
factors 

0- RecompuCe 

1- Do noc 

0 

lEND 

Flag to indicate final 
call to RSMERG 

3HYES, 2HN0 

2HN0 
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This routine is used to merge form factors from two or more restart tapes 
without the need of a form factor data block* The routine is called once for 
each restart tape* The user must be careful of the order of the node array* 
The first restart tape called must have the first nodes in the current node 
array. The second restart tape called must have the next group of nodes on 
the current node array and so on* Ct . :ntly, this feature is limited to three 
restart tapes, RSI, EMERG, and RSI2** All nodes which are not on any restart 
tape must appear last in the current node array. Thi.s routine writes a 
temporary restart tape for form factors only and turns off the RSI file after 
reading one form factor pseudo-file* This temporary restart file is read in 
lieu of RSI by the form factor routines* If any usable data is available on 
the RSI file subsequent to the form factors being merged, a call to RSTON must 
appear in the operations data just prior to reading it. Note that RSMERG uses 
the second file of an EMERG tape. EMERG is simply another name used in the 
re-use of data on a tape generated as an RSO tape* RSMERG is the first TRASYS 
routine set up to use the second file of an EMERG tape. 

4 * 3 . 9 . A Application of Restart Control Subroutines 

For TRASYS to read all of the data stored in a RSI tape, the user does not 
have to use subroutines RSTOFF and RSTON. For example, the situation where 
data is being computed ai d written to an RSO tape and aborts because of 
maximum time can be restarted and handled automatically by the program* With 
an RSI tape the program will always check, unless Subroutine RSTOFF has been 
called, to see first if there is valid data already available when executing 
those segments which take significant computer time. If the data can*t be 
found, then the program will begin to compute the data* The data search on 
the RSI tape is always forward* If there has been a call to RSTOFF previously 
and then followed by a CALL RSTON just prior to the execution of the current 
segment of the program , the program will search forward through the pseudo 
files of each restartable processor segment (see Appendix C) until it comes to 
an end-of-file or finds the match it is looking for in the header record for 
the current segment. If a match is not found, then no further data can be 
read from the tape* The current and all subsequent segment executions will 
require the data to be computed* The extent of the data search on the RSI, if 
the current segment is not immediately preceeded by a call to RSTON, will be 

*The RSI2 file is available automatically without definition in the Options 
data block* RSI and EMERG must appear in the Options data as usual* 
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Co advance only Co the very next resCartable processor pseudo file and Look 1 

for a match, [f one ts not found, it will compute the data for the current 
segment. It will continue through Che Operations Data block in sequence, 
executing each segment call in this manner. 


In Che case of a restart from an abort, if the Operations Data block is 
. 40 C changed, or at least the sequence of segments which retrieve the data 

remain Che same, Che program will read all of the data stored by Che aborted 

run and bvpass Che computation of the restartable processor segments until it 
can’t read anymore. At this point if it reads an end-of-file or the variable 

RSREC (see Section 3.2,1: Options Data Block) is less than the number of Che 

Last record read, Che program will begin computing any remaining operations 
data computations. If the end-of-file is reached, the computation would have 
picked up right where it last wrote Co the RSO Cape, An end-of-file should 
always be at Che end, even from an aborted run, because Che program always 
puts a end-of-file after each write to the RSO. Just before Che next write it 
will backspace over It and write the new data followed by a new end-of-file. 


The RSrON and RSTOFF subroutines allow the user to skip over data on the 
RSO cape that Ls not wanted or is known to be bad. It will also allow Che 
insertion of new segment executions in the Operations Data block while 
selectively retrieving the data available on the RSO cape. The user must be 
very cautious Ln retrieving data. V7>^at may be considered a match by the 
program may not really be a match. If Che same model and configuration name 
is used, and rlie node array hasn’t been changed, then for example, even chough 
Che form factors need Co be recomputed because previous input errors have been 
corrected, or modeling changes have been incorporated, the program may still 
utilise the form factors data on Che RSI Chat is known to be in error. In a 
like manner, a complete irrelevent set of DI data steps may be inadvertently 
retrieved from the run that created the RSI tape, even Chough Che orientation 
and/or orbit definition may be different in Che current run. An acceptabl^i 
program match would occur if the same model name, configuration name, and 
n«aster node array has been retained. In addition, tne step number(s) in Che 
i)l segintMits wiouLd have to be consistent. These risks exist of course, because 

h 

of Che extreme flexibility of Che program Co conveniently retrieve all useful ! 

data. In Che vxamples cited, the user must make a call to subroutine RSTOFF 
pri )t Lo the s giutot call wliere the existing RSL data should be bypassed. 
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The lollowing is an example of a situation that may occur. First, assume 
an RSO tape is created by a run that went to completion with the following 
Operations Data block. 

HEADER OPERATIONS DATA 
BUILD 

L NPLOT 

L NFFCAL 

CALL CBDATA (2HIR,3HTHING,0 ) 

L GBCAL 

CALL RKDATA (5HTHING,0,0 ,0, 3HYES, 0,0, 0,0,0) 

L RKCAL 

END OF DATA 


On a subsequent run, the RSO tape will be used as an RSI Cape so the form 
factor and IR gray body matrices can be utilized to compute some orbital 
healing rates that are desired. If the following Operations Data block is 
used, there should be no problem. 


HEADER OPERATIONS DATA 
BUILD 

L NPLOT 

L NFFCAL 

CALL GBDATA(2HIR,5HTHING,0 ) 

L GBCAL 

CALL GBDATA(3HS0L,5HTH1NG,0 ) 

L GBCAL 

CALL ORBIT2C3HEAR,0. ,90- ,0,0,0. , 150. *6080. , 150 .*6080. ) 

CALL ORIENT(4HPLAN,1,2,3,0. ,90. ,90. ) 

ORBGEN PLAN, 0. ,360. ,12, AQ, 0.0, 10000 
END OF DATA 

The node plot segment would ignore the RSI tape since this is not a 
restartable processor segment. The form factor * area matrix and the IR gray 
body matrix will be obtained from the RSI file since they occur on the RSI 
tape in the same order as the current Operations Data block. In the original 
run, the IR gray bodies are the last segment which wrote to the RSO tape 
(RKCAL does not), so no more restartable data appears on the tape. The 
remaining segment calls (generated by the ORBGEN card) in the current 
Operation Data block will result in computations. 


If the user however, reasoned that the program really doesn’t need the 
form factors until it is ready to compute the solar gray bodies and, instead 
of the preceeding, used the following Operations Data b^ock, a program abort 
would occur. 
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HEADER OPERATIONS DATA 
BUILD 

CALL GBDATA(2HIR,5HTHING,0 ) 

L GBCAL 

L NFFCAL 

CALL GBDATA(3HS0L,5HTHING,0 ) 

L GBCAL 

CALL ORBIT2(3HEAR,0.,90. ,0,0,0. , 150. *6080. ,150. *6080. ) 
CALL OR1ENT(4HPLAN,1,2,3,0. ,90. ,90.) 

ORBGEN PLAN,0.,360.,12,AQ, 0., 10000 
END OF DATA 


The abort would occur because Che program would check the RSI file to see if 
IR gray bodies are available. Although IR gray bodies are present on the 
cape, it would not look past the form factor psuedo file so a mismatch 
occurs. It would Chen attempt to compute the IR gray bodies, but would 
quickly abort because the form factor * area matrix, which it must have if it 
is to compute the gray bodies, has not been loaded or computed at this point. 

The following Operations Data block would not result in an aborted run, 
but also has a serious shortcoming: 


I 


HEADER OPERATIONS DATA 
BUILD 

CALL RSTON 

CALL GBDATA ( 2H IR , 5HTHING , 0 ) 

L GBCAL 

L NFFCAL 

CALL GBDATA(3HSOL,5HTHING,0 ) 

L GBCAL 

CALL ORBIT2(3HEAR,0. ,90. ,0,0,0. ,150. *6080. ,150.*6080.) 
CALL ORIENT (4HPLAN ,1,2, 3,0. ,90. ,90.) 

ORBGEN PLAN, 0. ,360. ,12, AQ, 0.. 10000 
END OF DATA 
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In the first GB cell, because of the RSTON subroutine call preceeding it, the 
program will not limit itself to look for a match in the header record of only 
the next available pseudo--file on the RSI tape. The program will search 
forward until it finds a match or the end-of-file. In this situation, it will 
find the IR gray bodies in the second psuedo file. When the form factor 
segment is executed, it will already be at the last psuedo file, so the 
program will recompute the form factors. The program would continue having to 
compute any remaining data. The form factor recomputation was unnecessary 
and, therefore, the first restart approach should be used. 

4. 3. 9. 5 Subroutine FFRSAD 

Calling sequence: CALL PFREAD 

When a complete set of form factors are on the RSI tape, a call to PFREAD in 
lieu of an L FPCAL or an L NPPCAL card will read the form factors on RSI into 
program data storage. This subroutine eliminates the need for loading the 
form factor segments. The subroutine is primarily used to save core in the 
Instructional banks and may provide additional core for data if the loading 
the alternative PP segment would have been the largest instructional bank. 
CThls feature is available on the UNIVAC version only). 

Restrictions: The form factor matrices on the restart tape must be complete, 

and no form factor data block Information will be used for the current 
configuration name. 

4. 3. 9. 6 Subroutine DIREAD 


When a complete set of dire<^t flux data for an orbit point Is on the RSI 
tape, a call to OIREAD In lieu of an L DICAL card will read the flux 
Lntormation into current-step data storage. This routine Is similar to PFREAD 
but Is for flux data. The subroutine eliminates the need for loading the DI 
segment. The subroutine Is provided to save In the Instructional banks 

and may provide additional core for data If loading the alternative DI segment 
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would have been the largest Instructional bank. If the DIR Option is used for 
the IFO variable in ORBCBN, DII^D is called in each stap by the program. 

(This featura is available on the UNIVAC version only). 

Restrictions: Flux data for tha step must be complete and no flux data block 
information will be used for the current configuration name and step number. 

4.3.10 Planet Surface Subroutines 


Subroutines SURFP, DIDT3, and DIDT3S provide a package that allows the 
user to locate his configuration on the surface of a rotating planet. Solar 
flux histories for a planetary day may then be computed by updating time of 
day and executing the DICAL segment. Planet rotation data and above 
atmosphere solar constants are provided internally for Earth, Mars, and the 
moon. The user controls atmospheric attenuation of the r.olar flux through a 
program variable called the atmospheric extinction factor. DICAL 
automatically avoids planetary albedo and infrared flux calculations for this 
option. A ground plane of arbitrary size and appropriate optical properties 
should be included in the configuration. Solar reflection from this plane is 
analogous to albedo flux, and infrared energy interchange calculations with 
this plane in the thermal analyzer will account tor the infrared environment. 

4.3.10.1 Subroutine SURFP 


Calling sequence: CALL SURFP (PNAME, ALAT, SUNLAT, ASX) 

This subroutine spatially locates the sun vector relative to the 
configuration on the rotating planet, defines planet rotation rate, and sets 
variables used to compute the solar "constant" as attenuated by the atmosphere 
as a function of the time of day. A change in any of the SURFP arguments must 
be accomplished through a call to SURFP. 
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PNAME (option* 3HBAR, 3HMAR, 3HM00) defines the following variables: 

2 

SOLO ~ solar constant outside the atmosphere, BTU/hr ft 
(429.0 for Berth and moon, 183.2 for Mars) 

PER - Rotation period of planet, hours 

If a value other than the built in nominal for SOLO is desired, SOLO is 
redefined as desired in the operations data block subsequent to the SURF? call 

ALAT is the latitude of the configuration on the planet, degrees of arc 

SUNLAT is the solar declination in degrees of arc. If PNAME “ 3HEAR, 
SUNLAT must be a day of year (l.^ SUNLAT^ 365.) so that solar declination 
can be computed from an ephemeris equation. 

AEX is the atmospheric extinction factor that appears in the equation: 

SOL - SOLO/EXP (AEX/COS(PHI) ) 

where: SOL ■ attenuated solar "constant" 

SOLO * solar constant outside atmosphere 
PHI " angle from local vertical to sun vector 

Values for AEX may be found in the growing literature on solar energy 

conversion. Representative values are 0.25 for the southwest desert and 0.45 

for southeastern coastal areas. An alternative to entering AEX is to enter a 

2 2 . 
flux level, in Btu per hr-ft that is desired at solar noon (300 Btu/hr-ft is 

typical). The argument AEX is tested by subroutine SURFP. If greater than 

I.O, noon solar flux is assumed, and a corresponding extinction coefficient is 

computed and stored for use. 

Note: The TRASYS approach to the planet surface environment does not yet 

include diffuse sources of solar energy such as clouds and atmospheric 
backscatter. 
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A call Co SURfP compucta eha two program variablaa DAMN and DUSK, eha | 

A 

cimaa of day for sunriaa and aunaac, raapaecivaly. Thaaa may ba uaad aa 
poinCa in cha haac flux cablaa in cha aama way aa SHADIN and SHAOUT for 
orb icing configuraCiona. 

4.3.10.2 Subroucinea DIDT3 and DIDT3S 

Calling aequaneaa: CALL DIDT3 (DINOSH. DIACCS, ITOD. DIPNCH, ISPAC) 

CALL DIDT3S (ITOD, ISFAC) 

These subroucinea provide accuracy paramecers and eoncrol flag 
definicion for Che DICAL aagmenC when using Che planec surface opcion. 

DINOSH, DIACCS, DIPNCH and T.SFAC are die usual direcC IrradiaCion 
accuracy paramecers and eoncrol flags. (Ref. SecCion 4. 3. 5.4: Subroucinea 

DIDTl, DIDTIS) ITOD is Che cime of day since midnighc, houra/minuCes , 4-digiC 
inceger (e.g. , 1537 for 3:37 PM, 0820 for 8:20 AH). Time of day may ba inpuC 
in decimal hours through Che operacions bloclc scacemenc TIMEPR * DV. TIMEPR 
may also have "DUSK” and "DAWN" as daca values. TIMEPR is Che Cime of day 
since midnighc, hours. 

4.3.10.3 Orientation on Planet Surface 

The planec surface opcion requires chac Che central coordinate syscem 
of Che problem geometry be oriented as follows: 

a) Che CCS s-axis is Che local vertical 

b) Che CCS y-axis points true north 

c) Che CCS x-axis points due t'asC 

No capability exists to orient Che configuration through subroutine 
ORIENT. If re-oriencacion is required, Che block coordinate syscem capability 
may be used. 
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5.0 PROCESSOR SEGMENTS 


3.1 Pictorial Plot S«— ent« 

5.1.1 Node Plotter 


Calling aequence: L NPLOT 

Thia aegnent providea the uaer with 3-dimenaional and/or orthographic 
projection pictorial plota of hia problem geometry. Ita primary uae ia to 
verify aurface data input prior to proceeding with computationa of radiation 
interchange cr abaorbed heat data. Examplea of ita ouput can ''e found in 
Appendix H. 

Thia aegment haa no proviaion for uaer intervention in the form of 
program called aubroutinea that the uaer may modify. Control ia provided 
through the NDATA or NDATAS aubroutinea. 

5.1.2 Orbit Plotter 


Calling aequence: L OP LOT 

Thia aegment providea the uaer «ith a pictorial representation of hia 
apacecraft in relation to the body it orbits and the auxi 

The planet and ita ahadow are depicted, together with a pictorial view 
of the spacecraft in orbit. The standard output enables the user to verif 3 ’ 
his orbit in relation to the sun, and spacecraft orientation relative to the 
aun, planet, or star. Examples of its output can be found in Appendix H. 

Thia segment has no provision for user intervention beyond that 
provided by subroutines ODATA and OD^iTAS. 
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5.1.3 D«ta Plottar 


Callint ••qucncet L PLOT 

This ••fient provides th« capability to plot any coaputad or input data 
aa X veraua y plots. Tha aafaant autoaatically writ<x« « binary plot data unit 
(disc or drum) for producing plots of incident or absorbed heat rates or 
fluxes as a function of tiae. 

The segnent also provides a coaplately general ^\ot capability if the 
user inputs operations data block FORTBAH to prepare the plot data unit prior 
to executing the PLOT segeent. This type of plot operation is illustrated by 
the plot unit format described below. 

The plot segment flow diagram is shown iu Figure 5**1. 

5.1.4 Binary Plot Dnit Pormat 

Write format: HAME, H, (DATA (I), I - I, N) 

where: 

H/ilE: type of record 

N : number of words in data array 

DATA: array of data 

Record I, TYPE - FRAME 

word 1 5HFRAME 

2 4 

3 XMIH 

4 XHAX 

5 YMIN 

6 YMAX 
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Record 2, TYPE - LABELX 


word 1 6HLABELX 

2 MAXIMUM OP S 

3 LABEL ARRAY 

4 

5 

6 
7 

Record 3, TYPE - LABELY 

word 1 6HLABELY 

2 N(MAXIM0N OP 7 

3 LABEL ARRAY 

4 

5 

6 
7 


(30 cherectere, sexima, per word) 

( 1 ) 

( 2 ) 

(3) 

(4) 

(5) 


30 Cher ec cere, aexlatflt, per %rord) 

( 1 ) 

( 2 ) 

(3) 

(4) 

(5) 


Record 4, TYPE - NODENO 


word 1 6HNODENO 
2 1 

3 INTEGER NODE # 
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Figure 5-1 PLOT Segment Flow Piagratn 
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Record 5 , TYPE - TITl-E 1 

word 1 6HTITLE 1 

2 NCMAXIMtm OF 10, 

3 TITLE ARRAY 1 

4 2 


60 characters, 


maximum, per word) 


12 10 
Record 6, TYPE - TITLE 2 
word 1 6HTITLE 2 

2 NCMAXIMUM of 12, 72 character, maximum, per word) 

3 TITLE ARRAY 1 

4 2 


14 12 

Record 7, TYPE • INLEP, N ■ user supplied 

word 1 5HINDEP 

2 N (1 ^ N ^ 1000) 

3 DATA ( I ) 


N+2 DATA (N) 
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) 

Record 8, TYPE <■ DEPSHD, N ■ user supplied, (must sgree with number of 

independent date values) 

word 1 6HDEPEMD 

2 N (I^^N^IOOO) 

Note: a) TYPE DEPEND can occur as sumy times on a file as desired 

for multiple plots on a frame. 

b) Any records but FRAME, INDEP and DEPEND types may be 
omitted. 

c) Record 8, words 3 through N 4- Z same as record 7. 
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5.2 Hybrid Form Factor Segment 
Calling sequence: L FFCAL 

This segment computes form factor matrices for any geometric enclosure 
using a numerical integration method. Internode blockage is accounted for 
with differing solar and IR transmissivities and, because semitransparent and 
specular surfaces are allowed, two form factor matrices are computed: FFS for 

the solar waveband and FFI for the infrared waveband. 

Blockage factors are also computed, printed and written to the restart 
tape. Blockage factors are defined as follows: 

BFij - Fij (shadowed) 

Fij (unshadowed) 

Provision for user intervention via the subroutine data block is 
available through three program-called subroutines: (1) prior to computation 

of each form factor through subroutine FFPRE, (2) at the completion of a row 
of form factors through subroutine FFROWp and (3) at the completion of the 
entire matrix through subroutine FFEND* The logic flow of the FFCAL segment 
is shown in Figure 5-2. 

FFCAL provides printed output p as well as punched cards or tape in FORM 
FACTOT DATA Block format, at the user's option. Output is also written to the 
RSO and RTO binary restart tapes. 

FFCAL employs two techniques to avoid inaccuracies inherent to the 
double-integration form factor computation technique. First, it tests the 
node areas involved before beginning a computation, and makes certain that the 
factors are always computed from the smaller node to the larger node. Second, 
if an area-distance criteria is violated, a Nusselt-Sphere technique is used 
to overcome inaccuracy when the near corners of the node pairs are much closer 
together than the far corners. Theory on form factor calculation techniques 
can found in Appendix B. 
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5*3 Nusselt Unit Sphere Fona Factor Segment 
Celling sequence: L NFFCAL 

This segment computes form factor matrices for any geometric enclosure 
using a modified double integration method wherein each elemental form factor 
is computed using the Nusselt-sphere calculation method. The Nusselt-sphere 

technique is generally implemented^ as a single integration method. This 
leads to extreme computation difficulties when accounting for shadowing, so 
the technique used in FFC\Ly wherein the j-node as well as the i-node are 
broken down into elements, is retained. With this approach, shadowing 
calculations proceed in the same wiy as FFCAL, that is, with a check to see if 
the element-to-element vectors are interrupted by a shadowing surface. The 
Nusselt-sphere method, however, eliminates the inaccuracies encountered with 
FFCAL when closely adjacent surfaces are involved. 

The element selection technique used by NFFCAL is basically user controlled. 

A specified number of elements is divided among the i and j nodes according to 
their areas. Along with the improved accuracy some increase in run time, 
compared to FFCAL, may be noted. 

The NFFCAL segment interfaces with other program segments and the 
restart tapes in exactly the same way as FFCAL. The printed output is also 
very much the same. The logic flow of the NFFCAL link is shown in Figure 5-3. 


K, A. Toups, A General Computer Program for the Determination of Radiant 
Interchange Configuration and Form Factors, North American Aviation Inc., SID 
65-1043-2, October, 1965. 


5-9 


NFMAIN 



Figure 5-3 Segment NFFCAL Flow Diagram 
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5*4 Radiation Interchange Segment 
Calling sequences: L GBCAL 

Segment GBCAL computes a matrix of diffuse gray-body (GB) radiation 
interchange factors and places them in out-of-core storage for later use in 
computing absorbed heat or radiation conductors. Solutions for either the 
solar and/or infrared wave bands may be requested. No user intervention 
provisions are made beyond that of subroutine GBDATA. The IR gray body 
solution is dependent upon form factors and emittances and the solar gray body 
solution is dependent upon the form factors and solar absorptivity. To 
compute the gray bodies, the Operations Data Block should call the appropriate 
subroutines to compute or load the form factors prior to the first GB segment 
call. 


5.5 Radiation Conductor Segment 
Calling sequence: L RKCAL 

Segment RKCAL computes radiation conductors for thermal analyzer models 
and provides output in punched card or BCD tape form for direct input to a 
thermal analyzer. A printout of the card/tape record images is also 
provided. Three program-called user routines are used to provide user 
intervention through his subroutines block. Subroutine RKPRE provides for any 
special initialization desired before computations begin. Subroutine RKPNCH 
performs the actual punch and tape write operations to the BCDOU file. The 
user may obtain data in any thermal analyzer program format by altering format 
statements in this routine* User routine RKEND provides for user intervention 
prior to return to operations block control. Figure 5-4 shows segment RKCAL 
logic flow. To compute the radiation conductors the IR gray bodies must be 
computed or loaded in the Operations Data block prior to the first call to the 
RK segment . 

An example of RKCAL output can be found in Appendix H. 
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5.6 Redietion Condenser Segment 
Celling sequence: L RCCAL 

Segnenc RCCAL computes redietion conductors, simplifies end condenses 
these conductors using the ERN end MESS techniques, end provides output in 
punched cerd end/or BCD tepe form for direct input to thermel enslyzer. A 
printout of the cerd/tspe record imeges, es well es the originel (uncondensed) 
RADRs, is elso provided. Three progrem-celled user routines ere used to 
provide user intervention throu^ his subroutines block. Subroutine RCPRE 
provides for eny specisl initislization desired before computetions begin. 
Subroutine RCPNCH perfonss the ectual punch and tape write operations to the 
BCDOU file. The user may obtain data in any thermel analyzer program format 
by altering format statements in this routine. User routine RvXND provides 
for user intervention prior Co return to operations block control. Figure 5-5 
shows segment RCCAL logic flow. RCCAL theory is presented in Appendix F. To 
compute the radiation conductors the IR gray bodies must be computed or loaded 
in Che Operational Data block prior Co Che first call to the RC segment. 

5.6.1 Sample Problem Using ERN/MESS Technique 

The optics housing of the High Altitude Observatory (HAO) solar 
telescope, which is mounted on the Skylab Apollo Telescope Mount, is shown in 
Figure 5-6. Both the original enclosure and the modularized enclosure are 
shown along with Che ERNs and Che MESS nodes. Figure 5-7 shows the nodal 
breakdown for Che enclosure. 

TRASYS input for subenclosure 1 (see Figure 5-7) is shown in Figure 5-8. 
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Figure 5-A Segment RKCAL Flow Diagram 
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Figure 5-6 HAO Experiment Optic* Housing Modularired Enclosure* 
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POOP 

•0.9, 

0.9 

MEAOE# 

FOR** PAC-^OR CATA 


TIG 

HAO 



NOOER 

l,2,7,A 

,5 *6, 7, 8, 9, 10, It *12*13, 14, 15. 16. END 


It 2t 

0. ITITOO 

• 90. • 


It 3, 

1.005768 

• 90. ♦ 


It At 

9.006289 

• «0. f 


It 6t 

0.104575 

• 90 . 9 


It Tt 

9.115291 

• 90. « 


It 8t 

9.060140 

• 90. 9 


It 9t 

0.043026 

• 90. • 


It lOt 

0. 032649 

• 90. 9 


It lit 

9.027951 

• 90. 9 


It 12t 

0.119A29 

• 90. 9 


It ITt 

9. 161426 

• 90. • 


It lAt 

9.106045 

• 90. 9 


It 19t 

0. 119960 

• 90. 9 


It 16* 

9.053506 

* 90. ♦ 


2t 6* 

9. 1609 44 

• 13.125 9 


2t T, 

9.BA0229 

• 13.125 9 


2* lit 

8.04T6 92 

• 13.125 9 


2* 12* 

0.1160 57 

• 13.125 f 


2* IT, 

0.029062 

• 13.125 t 


P* lA, 

9. 115054 

• 13.175 « 


2, 19, 

9.025691 

• 13.175 9 


2, 18, 

J. 007440 

• 13.125 * 


3, 6, 

0.021828 

• 9,75 5 


3, », 

9.290661 

• 9.75 9 


T, 11, 

0.309899 

• 9.75 9 


Tt 12. 

0. 174021 

• P.75 9 


3, lA, 

). 981130 

• 9.75 * 


A, *, 

0.004975 

• 9, 75 9 


A, T, 

0. C49930 

• 9.75 9 


A , 9, 

0.117956 

- 9,75 9 


A, 9, 

3.050475 

• 9 . 75 5 


At 19 , 

0.010519 

• 9.75 5 


A, 12, 

a. 1534 72 

• 9.75 * 


Figure 5-8 RCOAL Seaple Problea Input 
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«*, 

13, 

0.133690 

m 

9,T5 



i<*t 

O.I2424» 

¥ 

9.75 

t 

V, 

19, 

0.134899 

• 

9.75 


«», 

16, 

O." 660 18 


9.75 

f 


6, 

0.026614 


9. 10 

% 

5, 

7, 

0. 100976 

• 

9.10 

t 


8, 

0.239230 


9.10 

f 

^ f 

«», 

0.003409 


9. :i 

f 

5t 

10, 

0. OOQ460 

• 

9. 10 

f 

5, 

11, 

B. 029453 


9. 10 

f 

5, 

14, 

0.5485»26 


9.10 


5, 

15, 

0. 063.: o4 

♦ 

9. 10 


•»» 

16, 

n.D04413 


9.10 

% 

6» 

o» 

0.111436 

f 

71.765 


8» 

9f 

0.024529 

« 

71.765 

f 

8, 

10, 

0.009124 


71 . 76 , 

f 

6, 

11, 

0. 166134 


71,785 


•if 

12, 

0.254005 


71,765 

f 


13, 

0.B29930 

♦ 

71,765 

f 

6. 

14, 

0.260009 

• 

71,765 

t 

8» 

19, 

0. C34727 

* 

71 ,76« 

t 


16, 

3.011045 

• 

7l,7d«: 

% 


6« 

0.044039 

♦ 

72,065 

t 


9, 

0.061644 

¥ 

72.068 


7, 

10, 

0. 084668 

* 

7L , 065 


7, 

11, 

0.113617 


72,065 

t 


12, 

3. 126117 

4 

72 , 065 

t 

7, 

19, 

0.26 39 O'l 

4 

72.065 

t 

7, 

14, 

0.634592 

4 

72.065 

f 

7, 

18, 

3.280429 

4 

72 . 065 


7, 

1^, 

0.160369 

4 

72,06. 

t 


11, 

3. 154363 

4 

69 .470 


8, 

12, 

0.176175 

4 

69.470 

t 

8 1 

13, 

0.351306 

4 

69.470 


8, 

14, 

0. 223080 

♦ 

69.470 


a. 

15, 

0. 354360 

4 

69.470 


8; 

16, 

3. 114259 

4 

59,470 


9, 

11, 

n« 5 39565 

4 

31 .500 

t 

9, 

12, 

0. 82-'146 

4 

51.500 

t 

0. 

13, 

3.27} 1f3 

4 

31,800 


9» 

14, 

0.030298 

4 

51.«00 

f 


19, 

0.27 '746 

4 

31.500 

t 


16, 

0. I88(jqi. 

4 

31 .500 


‘3. 

11, 

3 . D06027 

4 

29.750 


1C, 

12, 

0.306476 

4 

29.750 

« 

io» 

13, 

0.247228 

4 

29.750 

r 

10, 

14, 

9. 110766 

4 

29.750 

-< 

10, 

19, 

0. 251456 

4 

29.750 

% 

10 

.6, 

0. 291733 

4 

29.754 


11, 

^2, 

0 2?0815 

4 

0 .203 

f 

ll, 

13, 

n > ; , c,74 

4 

60 ,700 


11, 

*4, 

0 -t*7?9<' 

4 

60.200 


11 V 

15, 

0.117968 

4 

60.200 


u. 

16, 

0. 029121 

4 

60.. :o'’ 


12, 

f 

0.154333 

4 

79,093 

f 

12, 

15, 

0. 344610 

4 

79,093 

t 

12, 

16, 

009757 

4 

79.093 

f 

17, 

14, 

9 . 052"a2 

4 

(*8.537 

t 

1*, 

15, 

9 . .90832 

4 

88.537 

t 

11, 

It, 

0.1:^6787 

4 

66 .*=37 

S 

!<♦, 

16, 

0. 91 37#-5 

4 

66,193 

H 

18, 


1 7J?17 

4 

66.537 

X 


Figure 5-8 RCCAL oample iroblem Input (cont) 
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HEADER CORRESP(»)DENCE DATA 


HAO 


2266 

=1 

2270 

-2,: 

2255 

-6 

2254 

=■7 

2252 

«8 

2243 

-9 

2253 

-10 

51 

-11 

2264 

-12 

2265 

=13 

2259 

*14 

2258 

=15 

2240 

*16 


HEAD OPERATIONS DATA 
BUILD HAO, ALLBLK 

CALL FFDATA(0, 0,0, 0,0,0, PUN, NO, 0,0) 

L FFCAL 

CALL GBDATA(2HIR,3HHAO,2HFF,0) 

L GBCAL 

CALL RCDATA{3HHAO, PUN, 0,10000,0, 999, 0,1./144., NO, 0,0, 
1 0.9,91,IPRIME,ISECND) 

L RCCAL 

END OF DATA 


Figure 5-8 RCCAL Sample Problem Input (concl; 
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5.7 Direct Irradiation Segment 
Calling sequence: L DICAL 

l 

h' 


I 


When using the externally - supplied shadow factor tables, DICAL will 
revert to an analytic calculation each time a shadow factor table must be 
interpolated over a shadow factor range greater than allowed by Subroutine 
DISTAB. Selective use of shadow factor tables for different sets of nodes can 
also be specified through Subroutine DISTAB. 

Four program called subroutines are provided for user intervention 
through the subroutiiie data block. Subroutine DIPRES provides for special 
initialization prior to solar flux calculations. Similarly, DIPREP is called 
prior to planetary/albedo flux calculations. Subroutine DIENDS and DIENDP 
provide for user intervention subsequent to solar and planetary/albedo 
calculations, respectively. Figure 5-9 depicts the logic flow of segment 
DICAL. 


This segment computes the thermal radiation directly incident on 
external spacecraft surfaces due to the presence of the sun or a nearby 
planet. Three components are computed: direct solar, reflected solar from 

the planetary surface (albedo) and infrared planetary emission. Shadowing 
effects due to internode blockage are accounted for. Normally, shadowing is 
computed analytically by determining if each vector from each node element to 
a heat source (sun or planet element) is blocked by an intervening surface. 

At the users option, shadowed fluxes may be computed by the ise of shadow 
factor tables on a restart (RSI) tape. This requires that the SFCAL segment 
be executed prior to any DICAL executions. If shadow factor tables are 
present on the restart tape, SFCAL will read the shadow data and make it 
available on a file used by DICAL. Depending on the options selected by the 
user through subroutine DISTAB, (Reference Sec. 4. 3.5.9) shadow tables will be 
used to a greater or lesser extent in direct irradiation calculations. 
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i 

\ 

DICAL output is pieced in out»of-core storage for later use in absorbed 
flux calculations* Output is also written to the restart tapes. In addition, 
direct irradiation data may be output to punched cards or the USERl tape in 
HEADER FLUX DATA block format at the User's option. A printout of the direct 
irradiation data is provided also. An example of DICAL output obtained 
utilizing the ORBOSN option (See Section 3.3.9*2: ORBGEN Option) can be found 

in Appendix H. 

To compute fluxes, the Operations Data block must contain the orbit and 
orientation parameter definitions, if applicable, prior to any DI segment call. 

If all of the flux values are already available on the RSI tape, the 
DIREAD subroutine (Reference Section 4.3.11: Subroutine DIREAD) may be used to 
load them in place of the DI segment call (UNIVAC only). 
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5*8 Shadofw Factor Segment 
Calling sequence: L SFCAL 

This segment computes shadov factor tables for each node of a 
spacecraft configuration to be used in direct irradiation calculations when it 
is desirable to save computation time at the expense of some accuracy. 

By including a L SFCAL call prior to any DICAL call the prograri will 
compute shadov factor tables for the given configuration, and/or utilise 
precomputed shadow factor tables to obtain, by interpolation, the solar and 
planetary shadov factors for each node and at each orbit point. The entry 
points to the tables are the nodal clock and cone angles for the position 
vector to the sun or to a specific planetary element. Inaccuracies occur 
because the tables do not accurately reflect shadow entry and exit points for 
all nodes. The user can minimize this to any desired degree by control of the 
DICAL segment. (See sections 5.7 and 4. 3. 5. 9, Subroutine DISTAB). Through 
utilization of the Shadov Factor Data Block (ref. Section 3.3.6) known shadow 
factors can be input and/or direction given for the computation or 
recomputation of selected portions of the shadow factor table. 

Primary output for this segment is a file on the RSO tape containing 
shadow factor tables for each node. This file contains shadow data according 
to a format as presented in Appendix C. The shadow factor tables are also 
output in printed form as they are computed. Shadow factors f^r both the 
solar and infrared wavebands are computed, because semitransparent shadowing 
surfaces are allowed. 

No user intervention is provided for this segment. Prior to an SFCAL 
call, the user may set a flag to obtain punched shadow factor data through the 
statement SFPNCH » 3HPUN. Punched output obtained will be in shadow factor 
data block format. 
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When shadov factors are read from an RSI tape the printout of the 
shadow factor tables are normally suppressed. They may be printed by 
including the statement SFPRNT » YES before the SFCAL call in the operations 
data. For additional background and detail | the reader is referred to Section 
3*3.6: Shadow Factor Data. 

5.9 Absorbed Heat Segment 

Calling sequence: L AQCAL 

This segment utilizes direct irradiation and radiant interchange data 
in out-of-core storage as input. From this, it computes absorbed heat values 
for each external spacecraft node. Internode reflections are accounted for in 
both the solar and infrared wavebands. 

No user intervention through the subroutine data block is provided. 

Segment AQCAL output is placed in out-of-core storage. Printed output 
of the Solar, Albedo and Planetary absorbed values with Correspondence Data 
applied is also provided as an option by inserting the statement AQPRNT "Yes 
prior to any AQCAL execution. An example of AQCAL output can be found in 
Appendix H. 

5.10 Absorbed Heat Output Segment 

Calling sequence: L QOCAL 

This segment utilizes absorbed heat data in out-of-core storage to 
provide heat source tables in thermal analyzer format. At the user’s option, 
heat versus time ’"ables and/or orbital average heat data are provided for each 
external node. 

Output is provided on punched cards or the BCDOU tape. Q versus time 
data is in thermal analyzer array data format, with a singlet time array and a 
corresponding singlet Q array for each node. Also punched are thermal 
analvzer interpolation subroutine cards for each node. Orbital average data 
punched in source data block format. 
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Standard output is in SINDA therioal analyzer format. Subroutine 
DAllMDA is used for the interpolation subroutine. Output for other thermal 
analyzers may be obtained by altering the format statements in subroutine 
QOSAVE and entering the altered version in the subroutines data block. Card 
image printout of QOCAL output is provided. An example can be found in 
Appendix H. 

Segment QOCAL logic flow is shown in figure 5*10. 

5.11 Form Factor Combining Segment 
Calling sequence: L CMCAL 

Segment CMCAL is used to apply correspondence dat« to a form factor or 
image factor matrix that was previously computed and placed in data storage. 
After applying the correspondence data, the resulting matrix of combined form 
factors is written to data storage for later use by the GBCAL program 
segment. CMCAL will apply the auto-correspondence data (generated by polygon 
input) and/or users-supplied correspondence data at the option of the user. 
User control is applied through subroutine CMDATA. CMCAL can be used to 
combine form factor matrices , as computed and/or stored by the FFCAL segment, 
or it can combine image factor matrices, as computed and/or stored by the 
RBCAL segment. Please note, however, that it is not possible to combine FFCAL 
output, and then attempt to compute combined image factors using RBCAL. The 
execution sequence must be FFCAL, RBCAL and CMCAL, in that order. The CMCAL 
flow diagram is shown in Figure 5-11. The reader should refer to Section 
3.3.8: Correspondence Data for additional background and detail. 

5.12.1 Image Factor Segment 

Calling sequence: L RBCAL 

Segment RBCAL is used to compute one aspect of the effects of spec- 
ular-diffuse surfaces on radiant interchange factors. When specular-diffuse 
surfaces are present, the form factors may be considered to have two com- 
ponents: the direct or geometric form factor from node I to node J, plus 
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the "image" components resulting from the images of node J as seen by node I 
in all visible specular surfaces. In TRA3YS, the direct form factors are 
computed by KFCAL or NFFCAL . RfiCAL is then used to generate the nodal images 
in each specular surface, compute the various form factors to the images by 
a hvbrid double summation method and add them to the direct form factors. The 
resulting modified form lactors, dubbed image factors, are written to data 
storage. Segment GBCAL can then be used to generate radiant interchange 
factors from the image factor matrix and nodal surface properties. 

Segment RBCAL considers first order specular bounces only, that is, 
images of images are not generated and considered. The remaining reflected 
energy after the first bounce is reflected diffusely. Another restriction is 
tliat specular - diffuse surfaces cannot be subdivided into nodes. They must 
be defined one node per surface in the Surface Data Block. Appendix I 
prest‘nts the theory used in RBCAL. The segment RBCAL flow diagram is shown in 
Figure 3-12. 


3.12,2 Image Factors Using Ray Tracing-Segment RTCAL 
Calling sequences: L RTCAL 

Segment RTCAL computes augmented form factors, or image factors. Its 
output IS exactly analagous and interchangable with that of RBCAL. Three 
inportant restrictions of RBCAL do not, however, apply to RTCAL. First, 
specular surface^ ni'ed not be planar in RTCAL. Second, a ray-tracing 
technique is accounts for energy reflected in a specular manner 

llu'ough as many specular "bounc»,'s" as desired by the user. Thus, the "first 
bounce image" resiriction of RBCAL is also overcome. Third, specular-diffuse 
sort aces Ao not need to be defined one node per surface. Direct form tc'^fors 
are computed, using the Nusselt sphere technique, within RTCAL. Thus, a call 
to FFCAL or NFFCAL prior to RTCAL is not required or appropriate. 

In the RTCAL computation technique, rays are not generatid unless the 
emitter node is in "view" oi a receiver node with a specular re iectivity 
component. Rays thus generated are traced until: a) they encouutv-»r i purely 

ditfuso sort ace; b) they are lost to space, or c ) they are reduced in 
strengtli, through successive specular bounces, to a user-del ined fraction of 
their emitted strength. 
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Figure 5-11 Segmenf CMCAL Flow Diegram 
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Figure 5-12 Segment RBCAL Plow Diegraa 
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The»e characttristic*, to(«th«r with th* fact that tha RTCAL 
rajr-tracing algoritha it not jrat optiaisad for ■ioiniB run tiaa, laadt to tha 
fnUcwlng atataa<^nta about tha uaa of RTCALt 

1) Ifuaarieal accuracy to any dagraa daairad can ba obtainad. 

2) Larga aodala (hundrada of nodaa) will raquira CPU tiaa aoaawhat In 
axcaaa of NFFCAL, (laaa than 2X) providad that apacular aurfacaa do not 
doainata tha problaa. That ia* if apacular~diffuaa aurfacaa ara in tha 
ordar of 10 parcant of tha total and ara not phyaically larga coeparad 
to the othar aurfacaa, raaaonabla run tiaaa can ba axpactad. 

3) Probleaa conaiating almoat cntiraly of apacular-diffu)?e aurfacaa ahould 
ba liaited to a few tana of nodaa unlaaa available computer raaourcaa 
are aaaantially not limited. Thia ia eapacially true if tha apacular 
reflectance valuea are generally above 0.5. 

Appendix I preaenta the theory uaed in RTCAL. A RTCAL flow diagram ia 
ahown in Figure 5-13. 

5.13 Direct Irradiation via Specular Surfacea - Segaent DRCAL 
Calling aequence: L DRCAL 

The total direct irradiation that reachea a nodal burfcce conaiata of 
that reaching it directly from the aun or planet element plua r Iiaf. reaching it 
from imagea of the aun aa seen in apecular surfaces. Segment DRCAL computes 
the irradiation resulting from the sun's image in the same manner that aepamt 
RBCAI. computes the specular-bounce components of the image factors. It has 
the same limitations as RBCAL at to single-bounce imager, planar specular 
surfacea only are allowed aitd cne-node specular surfaces must be input. 

In the present version of TRASYS, DRCAL does not compute the specular 
component of planetary irradiation because .t is not felt that the compute 
time is justified. The flow diagram for segment DRCAL is shown in Figure 5-14. 
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Figure 5-13 Segment RTCAL Flow Diagram 
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KN-1 

IN-1 


CALL DRENDS 


ROUTINE 


IN-1 



YES 



DALL 

DREND 



RETURN 


USER 

ROUTINE 


Figure 5-14 Segment DRCAL Flow Diagram 
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RESERVED WORD LIST - ALL SEQCNTS 
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I*LBFL 
liSSOS 
ICwBL ' 
Ifs 

IVCORF 

■nirw~ 

lORBIT 

IPLN A 

I cocof 

IRKCN 

IFSCR? 


IA2GPI 

IAS 

T'rmr' 

IHSTEP 

I*.'OXN 

HFPW 

lORNT 

I=>LSM 

lOOtio 

IRKNSP 

IRSI 


DTE 

ECC 

'FFAteS 

FFNOSH 

FOG 


HA 

IAQGBS 

I AUTOC 

IfqFf 

IKS 

INOXS 

lOPNV 

lOVL 

IPLUNT 

'icorMt 

IPQTX 

IRTI 


I SPEC 
I'^RALL 


ISP*/D 

ITRCAC 


IfRCS" 
I trcrh 


IIPLO'^ 


KETEPS 

LDI5EG 


KTRA J 
LDRSEG 


ALPM 

ANETX 

AMTY 

ANT2 

APf A 

XSUT< — 

AV 

BCOOU 

CGX 

CGY 

irrcfSiTsr 

~CIT»MAT 

COR9 

DAMN 

OIACCS 

OI?1S 



DTR 

DUSK 

ELPBEA 

EPISS 

TFCpB 

Frt^rsF^ 

FFPNCH 

FFPRNT 

GAUSS 

GBUBNO 

HP 

lAI 

lAQSOA 

lAQSOP 

ICALFL 

ICHECK 

TfTSho 

~~TFflPC 

ILLUHN 

IMESS 

I^JJPS 

INSHAO 

lOPMVU 

1 OPT XT 

IPA6E 

IPLAFL 

IPROMP 

IOOARy 

IP 

iPESEf 

IPOTY 

IROTZ 

ISAVE 

ISFAC 


maumiam 

ISTRT 

ISIRTP 

ITRCCO 

ITRCDO 

TT^ir- 

riffCAO 

ITRC71 

ITRC80 

KPCOOU 

KOJNT 

kpTO“ 

kstep 

LCMCOH 

LCMSEG 

LGBCCM 

LG8SE6 




NHOOIP 

N^'ODU 

.. N“OOLS . 
NO 

„ NN 
NQO 

NNOO 

NODE 

NNOOC 

NOSH 

N' EU T 

Nnrs 

NPLSR 

"NPNWP 

“NPTrT 

SPUN 

NPVU 

NRAN 

NPARR 

NRAY 

NPMOD 

NRil 

NPSI 2 

NPSO 

NRSP 





NVbWtU 


NPTI 

: NPTO 

NS 

NSCRR 

NSCRl 

NSCR2 

j NSCR3 

NSEOP 

NSEOS 

NSPEC 

NEprr 

' "NSPNO 


^ i>iS step ' 

NSTE R ■ 

N'TPOT 

NSTPL 

NSTSOL 

NSURF 

NTITLE 

NTC 

NTQP 

ntraj 

NUSERl 

NUSER2 


OPSCL 

OPNT 

OPSCL® 

PALP 

optihp 

PALL 

OPTIHS 

PERIOD 

OPTRUE 

PI 



PLCC 

PLC^S 

“Prco“ 

pccpvr 

PLL ABt 

PLLABY 

PLTITl 

PLTITZ 

PLTYPE 

plamp^ 

PLY»»pr 

PNAME 

pc 

PRAO 



— — 

PVH 

— avjmFT- 

yOFHPF 

QOPNCM 

QORMPF 

QOTAPE 

QCTMPF 

QOTYPE 

RflIH 



RALP 
imnrr — 

RATE 

— RK AHPF 

RAYMIN 

tnomr ' 

RB 

RKP1TCH 


9 PL AN 

f^rot — 

SMAO 

SCL«R 


STr^DEC 

Sb'NOEr 

Tni< -w - 

TITLE 

T«UftNI 


RS0L4P 

S^TTS 

SHADIN' 

S‘'LO 



STR 74 
SUNPyO 
T MGH I — 
T^E 

TRUEAN 


RSUN 

- y «T 

SHAOUT 

SPA CE 

SUN 

SUNRA 

TTwrp y 
TRIR 
TSTR 


STGHA 

SPINT 

TTAir- 

SUNCL 

TAB 

TTTTtr 

TPSO 

URA 



ZERO 


RTHET 

srp^mr 

SOL 

sreeli 

smcK 

SUNCO 

TAPE 

TI W SP- 

TRUANF 

USERl 



2 NPROT 






In nddieion to tha rasarvad word Hat abova, tha followint raaarvad 
words auat ba praaarvad whan working in tiM particular safMnta notad. 

Saipant AQCAL 

QDS, QDR, QDP, QAS» QAR, QAP, GBSO, GBIR, AQTEMP, ICATBG, ICOMB 
Sagpiant CMCAL 

DATA» FFVALI, FFVALS, lOOMB, ICATEG» IX, SCRIR, SCR80, SUH 
Sa^anta DICAL, DRCAL 

(fDS, (H>R, QDP, ISHAD, DATA 
Sagranta FPCAL, KFFCAL 

FPVALI, FFVALS, BFE, BFA, ISHAD, SUM, SUMS, INDXF, DATA 
Sealant GBCAL 

FA, SPACE, XSPA(Z, IX 
Sas^ent MPLOT 
MNP 

Sagwant OPLOT 
MSP, JSURF 
Sagnant PLOT 
IX 

SagaianC QOCAL 

NODET, QAVERG, lOOMB, IFIRST, AREAT, IX 
Sagpant RBCAL 

DATA, FFVALI, FFVALS, ISHAD, NRMSSl, MRMSS2, RBVALI, RBVALS 
Sagaiant RCCAL or URCAL 

ISPN, MSND, NDS, SF, SPACNO, EMIT, AREAT, £X 
Sagpant SFCAL 

ISHAD, QDP, QDR, QDS 

Segaent RTCAL 

FFVALI, FFVALS, BFE, BFA, ISHAD, SUM, SUMS, INDXF, DATA, SRIR, 
SRSO, NODERI, FFRSII, FFRSIS, IFRSIE, FFRSIA 


A-4 


Appendix B 

Form Factor Calculation Methods 


Appendix 


Bavision 3 


APPENDIX B 

FORM FACTOR CALCULATION tCTHOOS 
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ELEMENTAL GRID VARIATIONS • DOUBLE SUMMATION ICTNOO 


Th* form factor for two finite areas i A. and A. (Fig. B-l)» is de> 
fined as ‘ 
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Figure B-1 Detemination of Form Footers 


A finite-difference approximation of Equation [B-1] is 


IJ 
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[B-2] 


Equation [B-2] approaches an exact representation of Equation 
[B'l] as the size of the elemental areas, A^ and A^, approach 

zero. For identical, parallel, directly opposed rectangles, the 
empirical relationship of elemental area size-to-separation dis- 
tance versus form factor error shovm in Figure B-2 is obtained. 
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Figure B~2 Error Charaaterietiet for Identioalf Parallol 
Directly Oppcted Reotanglee 

For Chit €«§«• 

Ai - K r£j2 

vhcr* K it a proportionality conatant. 

A note general font of Equation (B-2), conaidering that 






MTIAP version l.O, LORAIP, and TIASTt/FFCAL uso Iquntion •*2« aodifiod with • 
thadewing constant, to eoaputa fora factors. The total nundbar (i.a., sisa) 
sad distribution of alaaantal areas is left to cba usar to define in HTIAF 
version 1.0 and LOBAIP. The nunber of eleaents to be selected is defined by 
the closest node a given node "sees.** The eelection of eleMnts, however, 
usually ends being sesMwhat arbitrary or siagly a satter of aconoaicsf 
i.a., the finer the grid, the aore aachine tiaa required. Xn reality, tha 
selection of eleaental areas is aa independent problea for each fora factor. 

The basic assuaption for reasonably accurata fora factors is, frea Iguatioo 
l>6, that the eleaental area sisa is saall coapared to the separation distance 
between two eleaents. 

TIA8Y8/FFCAL uses a technique using Equation B-6 to autoaaticslly select the 
eleaent grid sises of each node pair consistent with a user*defined accuracy 
paraaeter, FFACC. If all elsaental areas on each of two nodes were the saae 
•ise and had the ssac separation distance, r^^, the apparent auaber of ele* 
aents on s node to satisfy the accuracy value FFACC would be (froa Equation 
B-6) 


A^ Aj cos 0£ cos 0j 

"l- Ti-(FFACC7 VIJ2 ' 

since each eleaent pair on the two nodes aay have a different separation 
distancs, s different apparent auaber of equal-sised eleaents will be required. 


The jipprosch used in TBASTS/FFCAL is a simple srithaetic average of eleaent 
contributions, i.e., 


“opti* 




where a. 

I 

I sad J, 


and a. 
J 


are the initial 


cos 0{COS 0: 

J » 
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r. / 

auaber of eleaents arbitrarily chosen for nodes 
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Ttit initial iMMibar of alaMota ia ehoaan juat latga aoough for a 
rapraaantaciva aaapla* A aiailar epciwHi nuabar of olaaMnea for noda J can ba 
dafinad. 

Tha total OMibar of alaaaota dafinad by Equation (b-0) ia diatributad 
uniformly ovar tha noda uaing a critarion that attaapta to aaka tha alaaaota 
aquara. Tha arithaatic avaraga taehoiqua aaauaaa ihsi tha aaao aaparatioo 
diatanca batwaan oodaa ia larga coaparad aith tha variation of aaparatioo 
diataoca ovar tha tao oodaa. A ehaek ia aada to aaa if thia aaauaption ia 
violatad. lha aaxiaua nuabar of alaaaota dafioad by any alaaaot pair oo tha 
ew oodaa (Equation (b~7)) ia coaparad aieh tha arithaatic avaraga valua 

(Equation (B-8)). If tha ratio of M^ai^opc g*«a>^«r than FFRATL, tha 

primary program braochaa to a Nuaaale'-Sphara calculation taehoiqua to 
calculata tha fora factor. Tha taehoiqua uaad ia tha aaaa aa praaantad io 
sactiona C and D balow. Thua, tha FFCAL aagaant uaaa a dual approach to fora 
factor calculation. Whan tha aituation allova it, tha computationally faat 
doubla auanMtion aathod la uavd. Whan thia aathod faila to provida accuracy, 
aa on adjacent nodaa with coaaon adgaa, the auparior accuracy of tha Miaaalt 
approach ia uaad. Sioca tha tiaa'~consuaing noda aubdiviaion uaed in pravioua 
varaiooa of TkASYS ia now aliaioatad, tha "hybrid” FFCAL ia now both faatar 
and Bora accurate than haratofora. 

B. MODAL PRELDfllMEY BMADOWINC CHECKS 

Shadowing ehacka batwaan alaaantal area a account for eonaidarabla aaehina 
tine. Machine tine could ba aavad if unnacaaaary chacka %rara aliainatad. The 
uaual procedure in MTRAP varaion 1.0 ia Co proceaa all tha aurfacaa until 
either the fora factor contribution ia reduced to aero by ahadowing aurfacaa, 
or all aurfacaa identified aa ahadowera have bean invaatigatad. Tha function 
of Che nodal ahadowing chacka ia to eliainate froa Che alaaeoc~co*’eleawnc 
ahadowing chacka all aurfacaa that cari^'i C eauaa ahadowing on any portion of 
the two oodaa under conaidaration* Tha technique uaad in TBASYS/FFCAL ia a 
aignificaot aodificatioo of the technique uaed in LOHARP. 
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Th« nodal thadowiog elioeka cocaiat of eonaeructing a apbora around aach noda 
for uhieh fora faetora ara bairg avaluatad and for aach ahadouing aurfaca. 

Tha radii of Cha apharaa ara auch chat cha noda or aurfaca ia co^ilacaly 
ancloaad. A caat cylinder or cona fniacua* dapaoding on cha ralaciva aixaa of 
cha cuo apharaa in quaacion, ia cooacruccad at ahoun in figure B>3. For cha 
cylinder, Cha radiua ia equal co cha larger of cha Cwo apharaa. lha cylinder 
or cona fruacun'a axial coordiaaca ia a reccor batuaan cha cancara of cha cuo 
a^araa plua cha aua of cha cuo aphera radii, Maxc, cha ahadowing aurfacca* 
ancloaing apharaa are checked co dacamiaa ubachar chay incaraacc cha caac 
cylinder or cona fruacun. Only aurfacea uhoaa aphara incaraacca Che caac 
cylinder or cona fruacuai will be eonaidarad in cha accual alaawnC'Co'alManc 
ahadowing chacka for chaaa evo node a. 

Thia Cachniqua of preliminary ahadowing chacka allowa idancificacion of any 
aurfaca chac ahadaa cha nodaa in quaacion. Howavar, ocher narginal onaa will 
alao ba idencifiad. 

In cha dacailad alamanC'Co^alamaac ahadowing chacka, an alaamnc pair ia aichar 
eonplacaly thadowad or ooc ac all. Tha accuracy, Chan, of rapraaarcing cha 
ahadow ia proporcional co cha cocal nwabar of alananca on boch nodaa. Tha 
nuabar of alananca on cha ahadowing aurfaca(a) ia of no cona idarac ion. In cha 
TRASYS program ic ia aaaumad chac accuraca ahadowing ia required only for 
larga>«agnicuda form faccora. If cha preliminary ahadowing chacka idancify 
ahadowing aurfacea for cha form facCor in quaacion, Che number of alaaanca 
defined Co rapraaanc cha ahadow ia 

H,i • Fjj b/(FFACC8) 

Haj - Fjj b/(FFACC8), (B-9) 

where 

FFACCS ia an ii^uc ahadowing accuracy faccor, and 
B ia a proporcionalicy conaCaoC dacacmined by crial and error. 

Tha number of alananca uaad for any given noda for form facCora ia cakan aa 
Cha maximum of chac defined in Bquacion (B-B) or Cquacion (B~9). 
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Figure B-3 Nodal Preliminary Shadowing Techniquea 
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C. NUSSBLT-SPHERE PORN FACIOR FORMULATION 


The general equation for the fora factor between finite areas A^ end 
A2 is (see Figure B*> 4 ). 

fl2 • I f f co« ei cos 62 <lA2dAi (1) 

Aj Jk\ Jk2 

The following part of the integrand is the factor froa the eleaental surface 
dAj^ to the total surface A2, referred to as the configuration factor or 
plane point factor, Cj^2* 


«12 

Therefore, 

^12 


i 


cos 01 cos 02 dA2 


_L f «12 <*^1 

Aj J ki 


( 2 ) 


( 3 ) 


A very simple geometric interpretation of Equation 2 is given by 
Nusselt. The principal value of the Husselt concept is that the computational 
procedure is simplified and made more accurate by the fact that no 
mathematical or numerical integration is required to compute the configuration 
factor. However, the Huaaelt method yields only the configuration factor from 
the elemental area dA^; one must still integrate all such factors over 
surface to yield tht form factor f^2 given in Equation 3. 


The Nusselt concept utilises a hemisphere of radius R constructed over 
the incremental plane area dA^, as shorn in Figure !• Every point defining 
the boundary of surface A 2 is projected radially to the hemisphere surface 
and then vertically downward to the plane of dA^, the equatorial plane of 
the hemisphere. The locus of all points thus projected encloses an area, 

A*'^, on the hemisphere base. This area A ^*2 » divided by the area of the 
base, is the corf iguralion factor from dA^ to A 2 . 
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The validity of this concluaion can ba daaooatratad as followa. Note 
that the alaaaatal area dA2 is dascribad in aurfaca A2 by tha alasantal 
solid angle d«^, or 


dwj - CO* »2 
S2 


(4) 


Similarly, on tha sphere having radius R, 


d«r 


1 



(5) 


Because dA2 is the projection of dA2 on the hemisphere base, 


dAl » 


cos 0} 


( 6 ) 


Inserting Equation 6 in Equation 5, 


“''I -ilL 


R^cos ©1 


(7) 


The right side of Equation 4 appears explicitly in Equation 1 and, because 


Equation 7 is identical to Equation 4, Equation 2 becomes 

. X . A« 




c._ ■ I cos 0J dA'2 

'*2 R^cos 0 


1 


>rR^ 


^2 

>tr2 


For a sphere of unit radius (unit sphere), 





n 


( 8 ) 
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vhich conpletes the proof of Husselt's aethod. By inserting Equation 8 in 
Equation 3, the original equation becoaes greatly sioplified; only one ares 
integration is now required. 

*12 ■ 4_ f il <»> 

*1 A, ’ 

A simpler and more easily understood geometric derivation, using the 
unit sphere, yields the same result in superior computational fora. Referring 
to Figure B-5, note that the radial projection of line segsmnt AB on the 
hemisphere surface forms the circular arc A'B*. Projection of A'B* to the 
base plane produces the elliptical arc A"B", forming the elliptical section 
A"OB" with the origin. 

If all line segments describing surface 2 are similarly projected the 

•• • ... 
area A 2 will be formed by a closed series of elliptical arcs# Surface A 2 

M 

does not have to be a plane. Actual ly» the area A 2 results from the 
geometry of a silhouette; any surface or object projecting an identical 
silhouette in the same spatial position on the hemisphere surface will produce 

II 

the same area A£ and the same point form factor. 


Inspection reveals that the magnitude of area A 2 can be determine.';^ by 
computing the area of each elliptirsl sector, properly signed, follom.i by an 
algebraic summation. 


In Figure B-5, the area of elliptical sector A is the projected area 

of circular sector A . If the angle between the plane of the circular 

8 

sector A'OB* and the xy plane is Y, then 


cos Y 



( 10 ) 


The area A, is computed from the usual polar equation, with 0 in radians, 


A, • \ r20 
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For Che unit radius tphtrs, 


^ “1 
2 


( 11 ) 


Substituting Equation 11 in Equation 10, and solving for A , 


A 


- 0 cos 

I 


y 


( 12 ) 
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For s polygon of N sidesi Che net area A 2 is found by algebraic sunmation of 
all computed A • 


N 


A 


If 


2 



n ■ 1 


co« y„ 


(13) 


Substituting in Equation 8, we have 


c 


12 


N 

L. ®n 

2n 


n ■ 1 


(14) 


The absolute value notation will be explained later. The use of vector 
algebra greatly facilitates the computation of 9^ and cosy. Takingg for 
example directed line segments of OA and OB, the vector dot product is 


OA OB • xy^xg ♦ Y^Yg + 


(15) 


The cross product OA x in determinant form is 


SX X 


i j k 

*A YA *A 
’‘B YB *B 


which, upon expansion, becomes the normal vector Vjj, 


- OA X OB - (y^zg ~ z^ygli ♦ (xgZ^- *B*A^j * ^*AYB ' *BYa^'‘ 
where i, .i , and k are mutually orthogonal unit base vectors directed along the 
principal axes. 

is equal in magnitude to twice Che area of Che triangle AOB and is 
oriented normal Co the plane of AOB so chat the three vectors form a right 
handed system. The magnitude is computed by Che Pythagorean theorem, 

Vn • V ^YA*B ■ *AYb)^ ♦ ^JtB^A " *A*b)^ * ^^AYB ’ *BYa)^ (17) 
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The angle 8 may be evaluated from either the dot or the cross product by use 
of inverse functions, specifically 

8 - cos-1 r or sin-1 f Vm 1 

OA OB J OB-j 

However, an overall economy of computation results from the use of the arctan 
function. 



As noted earlier, the angle y is defined as the angle between the plane 
of AOB and the xy plane. It is also the angle between the vector and the 

z axis; cos y is therefore the direction cosine of with respect to the z 
axis. Using the z component in Equation 16. 

cosy- ^A^B - ^B^A (19) 

^ 

If the numerator and denominator are both divided by 2, 


XAys - *ByA 

cosy- 1 

2 

Tnis shows that cosy is also equal to the ratio of the signed projected area 
of triangle AOB on the xy plane and the plane area of triangle AOB. 

In the right-handed system sho«m, cosy is positive when the order of 
computar.ion of the vectors in the cross product causes the normal vector 
to point in the direction of the axis (0>)'>90). The order in which one 
proceeds from point to point on the boundary of surface 2 will sign each 
elliptical sector accordingly; however, because the sectors are summed 
algebraically, the same absolute magnitude will result regardless of order. 
Because the point factor is always a positive number, the order is 
computationally unimportant. 
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The relscive esse with which the point factor can bw computed is best 
illustrated by an example. Using the triangle shotra in Figure B-5 and 
starting with line segment AB, from Equation 15. 


OA • OB*l+3+9"13 

From Equation 17 

|Vab| ■ joA X 5lj - ^(-6)2 + 0 + (2)2 - ^ 40 

From Equation 18 

©AB * 

From Equation 19 

y AB"^ ■ 

Moving to BC, 

OS-CC-3+3+9-15 
|Vgc| “ ♦ 6^ ♦ (-8)2 - \/l36 

6bc - tan-1 j ■ 0.661 

cosy BC " -8 ■ -0.686 


- 0.453 
13 
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Finally, lina aagaMnt CA, 

OC*OA»3 + 1^9«13 

VCA - VJT 6^ ♦ (-2)2 - ^JuO 

Ocx - tan‘^ • 0*^53 


CO* CA • • 0*316 

The conf iguracion factor la, therefore, from Equation 14, 

c . 1 I 2(0.453) (0.316) ♦ f0.661) (-0.686) 

1^ Tff I 


1^ 

2n 


-0.167 


■ 0.0266 


Note the repetitive nature of the computation. Thua, all aurfaces 
repteaented by atraight line aegmenta in apace can be analyzed in the aimple, 
direct manner ahown. 

D. ELEMENTAL GRID CONSIDERATIONS - NFFCAL 

The above formulation and computational method development reaulta in a 
aingle-integrat ion method for form factor computation that ia very efficient 
in computer time uaago and haa no accuracy ?imicationa. Thia method haa been 

applied in the paat with aome degree of aucceaa.^ 


Ir.A. Toupa, A General Computer Program for the Determination of Radiant 
Interchange Configuration and Form Factora, North American Aviation Inc., SID 

65-1043-2, October 1965. 
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Th« drawback co thia approach ia ancounctrad whan conacruccing tha 
ailh tuacca of aurfaca in configuraciona coononly ancouncarad. Firac, tha 
curved boundariaa of aurfacaa of revolution auaC be accounted for. Thia in 
ovarcoaa by approxiauicing each arc with a aufficianCly large nuaber of pointa 
in apace, connected by atraight linaa. Tha real problea ia encountered whan 
atteapting to trace tha conjunctive outline of aurfaca A 2 and all tha 
blocking aurfacaa intervening between an alaaant on A^ and aurfaca A^. 
Attaapta to do thia have lad to coaputational aathoda that are axtraaaly 
coeplax and prone to fail. 


Tha aathod of overcoming thia in NFFCA7. rataina the inherent accuracy 
of tha Nuaaalt-Sphara aathod while retaining the aiapla logic daacribad above 
where blockage ia not a consideration. Thia ia dona by accepting aoaa 
run-tiaa penalty and utilii.j.ng a double-integration aathod that will alwaya 
yield fora factora to any practical degree of accuracy daairad, ragardlaaa of 
the arrangaaent of the aurfacaa involved. The governing aquation for thia 
approach ia 



note that thia ia merely a form of equation (9) above. 


If aurface 1 and 2 are aubdividad into N and M aub-aurfacaa, (eleaanta) 
respectively, the following is a double-auamation equivalent of (20). 


N 



i ■ 1 


M 



j ■ 1 



( 21 ) 


Where . is a blockage factor, taking the value either zero or 1.0, 
depending upon whether the line connecting element i and j is interrupted by 
an intervening aurface. 
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The fundncntal algorichai used in HFFCAL nnd cloacly adjacent node* in 
FFCAL it baaically Equation 21. For •ach tlnawnt pair, Aj it conputad by 
the Mthodt of Equttiona 13 through 19 above. The eleaentt are telected and 
tised uaing the taaie aethoda employed in the regular double integration code 
and the eleaental ahape ia alwaya either three or four cornered. The blockage 
factora, are aleo obtained by the double integration aethoda. The 

preahadiwing atrategy, wherein only the liat of poaaible blocking aurfacea arc 
examined for each S^j vector ia alto incorporated. The atrategea of 
re-ordering the liat of blockcra to ainiaiae the acarch time required to find 
a aero valuad ia alto incorporated. Thia acheae ia baaed upon the 
aaauaption that the aurface that interrupted an S. ^ vector the meat likely 
candidate to block where the jel eleaent ia adjacent to j. 

In NFFCAL and for cloaely adjacent nodca in FFCAL the total eleaent 
count for each node pair, M ♦ N, ia a uaer input with a default value of 30. 
Inputa of 2 through 200 arc accepted. The total number of eleaenta arc 
diatributed over A^ and A^ according to the following: 

a. Aa nearly aa poaaible, the aurface area of each eleaent ia a 
conatant, that ia, if A^ ■ A^/T, M “ M/2, approximately. 

b. On a aurface of revolution, the circuafercntiel diaenaion of an 
eleaent ia never al!owed to aubtend mon than 18 degreea of arc. 

Under theae rulea, uaing the default total clcaMnt count of 50, 
accuracy ia obtained chat appeara acceptable for alaoat all applicationa. 

For closely adjacent oMe pairs or where there ia a coanon edge, 

(S. . ain «S. . max) NFFCAL ‘^c- jracy ia auch better chan that attainable 

ij ij 

with ordinary double integration. Typically, energy conaervation better than 
3 percent can be expected with the default element count. Thia ia why the 
NuaselC-aphere technique waa integrated into the FFCAL aegaent for closely 
adjacent nodes. 
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E. 


) 

DIRECT CALCULATION OF FORM FACTORS TO SPACE. 

NOTE: (This feacun not ivailabla in CDC vtraion.) 


In cht chttMl analyais of spacecraft, font factors to space larger 
than approxisMtaly 0.01 are frequently the most significant factor in 
establishing nodal temperatures. Thus, accuracy in calculating this form 
factor is essential. The indirect method used in RKCAL and RCCAL is 
equivalent to: 


n 


F 

I 



F. . 


for an n^ode configuration where node i has a "view'' of space. Experience 
has shown that this approach is sufficiently accurate for all F^^ greater 
than O.l* However, it has been found that tighter^than defualt accurancy 
criteria may be required when temperature prediction is critical for nodes 
with F^^ « 0.05. 

This means of obtaining the F^^ presents a serious problem to the 
analyst faced with the need to conserve computer resources when a several 
hundred node configuration is involved. He feels, justifiably, that 
calculating hundreds of form factors of the magnitude 0.01 or less is wasteful 
and that budget could certainly be conserved if all node-to*nodc form factors 
less than say 0.01 cr even 0.03 were set to sero* This can easily be done by 
setting FFMIN to 0.01 or 0.03, but it has the unfortunate result of expanding 
Che values by exactly the sum of the form factors less than FFMIN. 

In order to sidestep thi« problem, co<.e to directly compute the form 
factor to space has been added to NFFCAL and FFCAL. This calculation is not a 
trivial user of CPU time. Therefore it should always be used in conjunction 
with an FFMIN of 0.01 or larger. Test cases have shown that for FFMIN • 0.01, 
an overall CPU time saving of about 20 percent can be expected for 300 node 
configurations. A larger number of nodes and a larger value for FFMIN can be 
expected to increase the tiote saving. 
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Vfhen Che option for Che direct calculation of F. is exercised, F. 

X S X a 

plus all Che form factors not eliminated by FFMIN are subtracted from 1.0 when 
Che calculation of a row of form factors is completed. This value is added to 
Che form factor F^^. This procedure, in effect, connects all individually 
insignificant radiation conductors from each node to a dummy node exactly 
equal in temperature. This approximation preserves the conservation of energy 
for each node and is justified by the assumption Chat nodes that can "see" 
each other will run relatively close Co each other in absolute temperature. 

The following is a summary of Che procedure used in calculating Che 
form factors to space; 

1. Each node is subdivided into planar elements according to Che user 
control parameters. 

2 . For each element, 100 rays are constructed, emioating from the 
element center, in directions such that they are evenly distributed 
over the inside of a hemisphere centered at Che element center. 

3. Using Che shadowing logic routines within TRASYS, it is determined 
which, if any, of the 100 rays are blocked by intervening surfaces 
and which are not. 

4. By virtue of their even distribution, each ray "re^/resents" a solid 
angle of "'/50, or 1/lOOth of the total energy emitted from the 
element. Thus the elemental form factor to space is: 

dF * — dA 
® 100 

where: Nu * the number of unblocked rays 

dA ^ the elemental area. 

5. The elemental form factor calculation is repeated for each element, 
and the form factor from the node to space is finally computed as 
the area'-weighted average of the elemental form factors. 
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APPENDIX C 
RESTART TAPE FORMAT 
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The master restart tape consists of two or nine data files, fsee 
Section 3. 3. 9. 8*1: Permanent Restart Output Tape - RSO). For Appendix C, two 

files will be assumed. The first file is written during preprocessor 
execution and the second during processor execution. The first file consists 
of edit history data and images of all active and inactive input data cards. 

The second file consists of one or more **pseudo-files" begun with a 
standard header record and ending with a standard trailer record, ^ach 
restartable processor segment (FFCAL, GBCAL, SFCAL, DICAL, RBCAL, CMCAL, RTCAL | 
and DRCAL) writes a pseudo-file containing the data necessary to restart an 
interrupted job with minimum repeated calculations. Also, there is a 
pseudo-file for each type of correspondence data, automatic, form-factor and 
GB. In addition, pseudo-files containing nodal property data are produced hv 
CMCAL, from any BUILDC/ADD series, or from anv series of calls to data 
modification routines (Ref. 4.3.8: Data Modification Routines.). The 

correspondence data and property data pseudo-files are provided only for use 
by special TRASYS/ thermal analyzer interface programs, and are not used in 
restart operations. Also, there may be a pseudo-file of direct-incident 
shadow factors for printout in restarted runs. 

HEADER RECORD FORMAT 

Word 

1 Record number (consecutive from beginning of file) 

2 DATE 

3 TIME 

4 AHHEADER 

CONFIGURATION NAME (6 characters, max.) 

6 RESTART POINT (restartable), ACCESS NO. (node, area, property arrays) or 
STEP NO. (absorbed fluxes and incident fluxes) 

7 One of the following UBEL words: FFCAL, GRIR, GBSO, SFCAL, CMCAL, 

RBCAL, RTCAL (with restart point); or FROPBD ( f \ am BUILDC, with access | 

no.); or PROPCG (from mod routines with access no.); or PROPCM (from 
CMCAL, with access no.); or AQCAL, DICAL, DRCAL (with step no.); or 
CORRES, CORRFF, SHF AC. 

8 TYPE OF COMBINING ( CM , AU , AUCM ) For CMCAL, GBIR, GBSO, AOCAL files; ioh 
number for other files. 

NO. OF ^K)DES for CMCAL, GBIR, GBSO, AQCAL files; date for other files. 

10 Thru 12 - SAME AS I THRU 3 
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TRAILER RECORD FORMAT 


Words 1 through 3 contoin rtcord auabsr, dact, tiaa 
Words 4 through 9 contain 3HEND 

Words 10 through 12 contain rtcord nusibtr, data, tiat 
CORRESPONDENCE DATA PSEUDO-FILE FORMAT 


Rtcord 

1 HEADER (contains C0RRE8 or CORRFF as labtl) 

2 THRU N - Corrtspondtnct data records. Each rtcord is 100 words or 
nuaibtr of nodts words long, whichtvtr is least. 

N 1 Trailer Rtcord 
PROPERTY ARRAY PSEUDO-FILE FORMAT 


Record 

1 HEADER (contains PROFID or FROPCG as label). 

2 4BN0DE, NNOD, (NODE(I), I <• 1,NN0D)* 

3 4HAREA, NNOD, (AR£A(I), I - 1,NN0D)* 

4 SKEMISS, NNOD, (EMISS(I), I • l,NNOD)* 

5 5HALFHA, NNOD, (ALPH(I), I - 1,NN0D)* 

6 4HTRIR, NNOD, (TRIR(I), I - l.NNOD)* 

7 4HTRS0, NW)D, (TRSO(I), I - l,NNOD)* 

8 4HSRIR, NNOD, (SRIR(I), I • l,NNOD)* 

9 4HSRSO, NNOD, (SRSO(I), I- l,NNOD)* 

10 Trailer record 

If label is PROPCM, records 10 and 11 contain: 

10 5HIC0MB, ICMBL, (ICOMB(l), I - l.ICMBL)* 

11 Trailer record 
where: 

NODE " Node identification nuabers 
NNOD • Nuaber of nodes in problea 


*Note: All data records begin and end with record nuaber, date and tiae 
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Mode surface properties (Ref. Table III*3) 


AREA 

ENISS 

ALPHA 

TRIR 

TRSO 

SRIR 

SRSO 


ICMBL • Length of ICOMB array 

ICOMB ■ Array of coabined node identification nuabers 


DICAL PSEUDO-FILE FORMAT 


Record 

1 Header (label • 5H0ICAL) 

2 NNOD, TIMEPR, TRUEAN, (NODE(I), I - 1,NN0D)* 

3^ KEPT, SKADR, SHADP, ((PUVT(I,J), I - l.NEPT), J - 1,3)* 

4^ (SUMR(I), SUMP(I), I - 1,NEPT)* 

2*NNOD+2 NMOD, (QDS(I), I • 1,NW3D)* 

2*NNOD>3 NNOD, (QDR(I), I - l,NNOD)* 

2*NNOD*4 NNOD, (QDP(I), I - l,NNOD)* 

2*NNOD<^5 (SUNPV(I), I - 1,3), ((PLDC(1,J), J • 1,3), 1 • 1,3) 

2*NNOD>6 NSURF, (IFS(K), IKS(K), (PR(I,K), I - 1,2), (DSTR(I,K), I ■ 1,5), 

(DIMS(I,K), 1 • 1,3), (PSH(I,K), I • 1,4), (( (TSTR(I , J,R) , J ■ 
1,3), T • 1,3) K - 1, NSURF), NSPEC, (ISPEC(I), SREFLI(l), 
SREFLS(I), I - 1, NSPEC) 

2*NNOD+7 Trailer record 

where: 

NNOD ■ Nuaber of nodes 

TIMEPR - Orbit time 

TRUEAN “ True anoaaly 

NODE ■ Node identification nuabers 

NEPT ■ Nuaber of eleaents on planet 
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SHAOK ■ Modt - pl«n«c shadow factor (solar wavaband)| NOTE: Thasa 

SHAOP • Moda - planat shadow factor (IR wavaband) | ara radundant 

PLAVT ■ Planar alaaant araa vactors (3 cosponants) with SHFAC 

Stnot ■ Pons factors froa neda to planar alcaanta psaudo fila. 

(solar wavaband) 

SUMP ■ Fora factors froa noda to planat alaaants (IR wavaband) 

QDS, QDR, QDP • Incident solar, albado and planatary flux values 

SUNPV • Sun position vector 

PLDC ■ Matrix to Cransfora vectors in the CCS to vectors in the 
planet-oriented VCS. 

NSURF " Nuaber of surfaces 

IFS " Array of shadower suface input sequence nuabers 

IKS “ Array of shadower surface type flags 

PR ■ Array of shadower surface transaissivitics in Che infrared 

and solar wavebands 

DSTR ■ Array of shadower surface diaensions 

DIMS ■ Array of shadower surface SCS origin position vectors in 

CCS 

PSH ■ Array of radii of shadower surface encoapassing spheres and 
CCS position vectors to the canters of Chose spheres 
TSTR ■ Array of aacrices to Cransfora vactors in the CCS 
Co vactors in Che shadower SCS's. 

ISPEC ■ Array of input sequence nuabers of specular surfaces 
SREFLl ■ Array of surface specular reflectivity in infrared waveband 

SREFLS ” Array of surface specular reflectivity in solar waveband 

NOTES: ^Records 3 through 2'*'MN0D-^1 exist only for circular planet oriented 
orbits. Otherwise this pseudo-file contains S records only. 

^All data records begin and end with record nuaber, date and ciae. 
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DRCAL PSEUDO-FILE FORMAT 


Record 

1 Header (label ■ SHDRCAL) 

2 NNOD, TIMEPR, TRUEAH, (QDS(I), QDR(I), QDP(I), I - l,NNOD)* 

3 Trailer record 

Reference DICAL format for variable definiciona. 


FFCAL or HFFCAL PSEVnX) -FILE FORMAT 


Record 

1 Header (label - SBFFCAL) 

2 LBNOOA, HMOD, (NODE(I), I - 1,NIIOO) 

3 IROW, J, K, FFSHOI, FFSHOJ, (FFVALl(I), I • J,K), (FFVALS(I), 

I • J,K), BFE (I), I - J,K), (BFA(l), I • J,K)* 

• 

• 

HNOO-*’2 Trailer record 
where: 

IROW - "Emi t :er” node number 

J ■ Integer location (in node array) of emitter node 
(I.CE.J.LE.NNOD) 

NMOO ■ Number of nodea 
NODE ” Node Numbera 

FFVALI » In-:'rared form factora from emitter node to receiver node 
FFVALS ■ Solar form factora from emitter node to receiver node 
BFE “ Blockage factora correaponding to each FFVALI 
BFA * Blockage factora correaponding to each FFVALS 
LBNODA - Node Array label (6HN0DARY) 


**N0TE: i'. il data recorda begin and end with record number, date and time. 
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AQCAI. PSEUDO-FILE rOttUT 


Record 

1 Hetder (label ■ SBAC.CAL) 

2 NMOD, TIMEPR, TRUtdR. (MODB(I), I •l,MMOO) 

3 mWD, (QAS(I), I - l.MMOO) 

4 MNOD, (QAR(l), 1 - l^MMOr) 

5 NNOO, (QAP(I), I - l,aI»D) 

6 Trailer record 

idiere: 


NNOD • Nuaber of nodes 

TIMEPR Orbit tiae 

TRUEAM • True Anoaaly 

NODE ■ Node identification nuabers 

QAS, QAR, QAP ■ Absorbed solar, albedo and planetary heat values 
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SHFAC PSEUDO-FILE FORMAT 


This pseudo file follows csch DICAL pseudo-file when ISFAC ■ YES end is used 
to printout the DI shadow factors for restart runs. 

Record 

1 Header Record (label • 5HSHFAC) 

2 (SHADS(I), I - 1,MK0D)* 

3 (SHADR(I), I - l.NNOD)* 

4 (SHADP(I), I - l.HNOO)* 

trhere: 


SHADS ■ Solar shadow factor 
SHADR ■ Albedo shadow factor 
SHADP ■ Planetary shadow factor 


*A11 data records begin and end with record nuaiber* date and tine. 
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CMCAL PSEUDO-FILE FORMAT 


Rtcord 

1 Htadtr record (label - SHOfCAL) 

2 NMODC, ICMBL, (ICATEC(I), 1 - l.NMOD), (ICOMB(I), I - 1,ICMBL), 
(MOOEC(I), AREAC(l), EMISSC(X), ALFBC(I), TRUC(Z), TRSOC(I), 
SRIRC(l), SRSOC(l), I - l.imODC)* 


NNODC^2 Trailer record 
where: 

MMODC ■ Mueber of nodea after coabining 
ICMBL ■ Length of ICOMB array 
ICATEG • Coabinittg Category, array 
ICOMB ■ Correapoodenee data array 
MODEC ■ Node no. array after ceaibining 


AREAC 

EMISSC 

ALPHC 

TRIRC Node property arraya after coabining 

TRSOC 

SRIRC 

SRSOC 

CBCAL PSEUDO-FILE FORMAT 


Record 

1 Header record (label ■ 4HCBIR or 4HCBSO) 

*NOTE: All data recorda begin end end with record nuaber, date and tiae. 
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2 IROH*, SPACE, (FAd), I - J.NNOD*) 


NNOD‘*'2 Trailer record 

where: 

IROH ■ Muaber of eaitter nodea 

SPACE * Radiation interchange factor to apace 

FA ■ Array of radiant interchange factora froa eaitter node to 

receiver nodea 

NNOD ■ Nuaiber of nodea 

J • Integer locator nuaber of node ItOV 

*MOTE: If CMCAL haa been executed, NNOD - MNODC and IROH > NODEC(J) 

Ri:CAL PSEUDO-FILE FORMAT 


Record 

1 Header Record (label ■ SHRBCAL) 

2 IROH, (RBVALKI), I - J,NNOD), (RBVALS(I), I - J,NNOD)* 


NN0D>2 Trailer record 
where: 

IROH • Node nuaber of eaitter node 

RBVALI ■ Array of "total" fora factora froa eaitter to all receivera 
(infrared waveband) "total" fora factor includea direct fora factor 
to receiver, plua fora factora to all iaagea of receiver aa aeen in 
apecular aurfacea. 

RBVALS ■ Saae, for aolar waveband 

*NOTE: All data recorda begin and end with record nuaiber, date and ciae. 
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J " Inttgtr locaCion for node IROW in NODE array 
NNOD ■ Numbar of nodta in problaa 


SFCAL PSEUDO-FILE FORMAT 


Record 


1 Header record (label ” 5RSFCAL) 

2 NNOD, (NODE(I), 1 • 1,NN0D)* 

3 (TABSHA (ICO,ia), ICL - 1, 19), ICO • 1,9 

4 (TABSHE (ICO, ICL), ICL - l,lvJ, ICO - 1,9 


2*NNOD*l (TABSHA (ICO, ICL), ICL - 1,19), ICO ■ 1,9 

2*NNOD*2 (TABSHE (ICO, ICL), ICL - 1,19), ICO • 1,9 

2*KNOD*3 Trailer record 

where : 

NNOD "No. of nodes 

NODE ■ Node no. array 

TABSHA ■ Shadow factor array - solar 

TABSHE ■ Shadow factor array - infrared 


*NOT£: All data records begin and end with record nuaber, date and time. 


c- ’ ? 

>■> A. a 


O 0 0« 

Clock angl«o 1 through 19 rang* from 0 to 360 in 20 incrMMnt* 

about th* central coordinate ayataa a-axia, (Sa* Figure C-*l). Tha 0^ and 
o 

360 pointa era rapaatad to avoid vrap-around interpolation. Coo* angle* 1 
through 9 ar* 180., 157.5, 135., 112.5 90., 67.5, 45, 22.5, and 0. dagraa* 
raapactivaly. 
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Appendix D 

Subroutine Descriptions 


APPENDIX D 


SUBROUTINE DESCRIPTIONS 


Subroutine 

Name Page 

ADD D-2 

AD SURF D-3 

AQDATA D-5 

BUILDC D-7 

CHoBLK D-9 

CMDATA D-10 

DICOMP D-11 

DIDTl, DIDTIS D-13 

DIDT2, DIDT2S D-15 

DIDT3, DIDT3S D-17 

DIREAD D-18 

DISTAB D-19 

DITTP, DITTPS D-21 

DRDATA D-2 3 

FFDATA D-24 

FFNDP D-26 

FFREAD D-2 7 

GBAPRX D-28 

GBDATA D-30 

LIST D-31 

MODAR D-3 2 

MODPR D-33 

MODPRS D-3 5 

MODSHD D-3 7 

MODTR d-3 9 


Subroutine 

Name Page 

NDATA, NDATAS D-41 

NFDATA D-43 

NODDAT D-45 

ODATA, ODATAS D-46 

ORBITl D-48 

ORBIT2 D-50 

ORIENT D-5 2 

PFFSHD D-53 

PLDATA D-54 

QODATA D-5 7 

QOINIT D-59 

RBDATA D-60 

RCDATA D-61 

RKDATA D-64 

RSMERG D-66 

RSTOFF D-67 

RSTON D-68 

RTDATA D-69 

SPIN D-70 

SPINAV D-72 

STFAQ D-7 3 

SURFP D-74 


SUBROUTINE NAME: 


ADD 


PURPOSE : 

This subroutine adds to the problem geometry all nodes/surfaces 
contained in BCSNAM. 

VARIABLE NAME : 

BCSNAM is a Block Coordinate System name of up to 6 characters. 
RESTRICTIONS : 

Call valid only after previous calls to BUILDC or ADD within current 
step. BCSNAM must be a block coordinate system name as defined in surface 
data. 

CALLING SEQUENCE : 

CALL ADD (BCSNAM) 

EXAMPLE : 

CALL ADD { EXTANK) 

RELATED INFORMATION : 

See BUILD CARD information - Page D'^8 
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SUBROUTINE NAME: 


ADSURF 


PURPOSE: 


This subroutine functions to add an adiabatic "closure'* surface to the 
problem geometry and adds the pertinent form factors to the form factor matrix. 


Variable Name: 


Description 


Default Values 


BCSN 


NFIGFF 


AREA 


Name of a block coordinate system None 

containing the ''closure** surface 


Configuration name under which modi- Current configura- 

fied form factor matrix is to be tion name 

scored 


Area of adiabatic "closure" surface 


Computed Area based 
on data in Surface 
Data Block 


RESTRICTIONS : 

Block coordinate system BCSN must appear in the surface data block with 
one and only one node (and, therefore, one surface). This surface must be 
completely defined in the Surface Data Block, including the surface properties 
desired for the "closure" surface. The concept to simulate an adiabatic 
condition would require very small IR emissivity. 

In addition it requires for the third argument an area equivalent to 
the smallest possible area required to close out the configuration as a 
complete enclosure. Physically this area may consist of one or more parts, 
for example, the ends of a long cylinder. Only one surface is required since 
only the true enclosure area is what needs to be preserved. If the last 
argument is zero, the program will use the area computed in the Surface Data 
Block. The dimension of this surface regardless of surface type must be such 
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that the computed area will be equivalent to the smallest possible area 
required to close out the configuration as a complete enclosure with one or 
mvore areas* 

1* The call to GBDATA subsequent to an ADSURF call must have GBWBND - 2HIR 
2. ACTIVE • Both is not allowed for the adiabatic "closure" surface. 

CALLING SEQUENCE; 

CALL ADSURF (BCSN, NFIGFF, AREA) 

RELATED INFORMATION 


See Section 4«3.3«4: Adiabatic "Closure" Surface and Appendix J* Use 

of Adiabatic Closure Surfaces. 
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SUBROUTINE NAME; 


AQDATA 


PURPOSE: 


This subroutine defines parameters used in AQCAL for calculation of 
absorbed heats. Direct fluxes for AQ calculations are obtained from current 
step data storage. 


Variable Names 


Default Names 


lAQGBS - configuration name 
lAQGBI - configuration name 
RSOLAR - multiplying factor 
RALB ~ multiplying factor 
RPLAN - multiplying factor 
NFIGCO “ configuration name 


for solar grey-body matrix* 
for IR grey-body matrix* 
for solar absorbed heat 
for albedo absorbed heat 
for planetary absorbed heat 
for correspondence data 


Current Config. Name 
Current Config. Name 
1.0 
1.0 
1.0 

Current Config. Name 


RESTRICTIONS; 


Must be called subsequent to a DICAL execution within same step. 

NOTES: If not called prior to an AQCAL execution (within same step), default 
values assumed. Individual default values obtained by passing zero 
argument s. 

CALLING SEQUENCE : 

CALL AQDATA (lAQGBI, lAQGBS, RSOLAR, RALB. RPLAN, NFIGCO) 

*NOTE: If lAQGBS or lAQGBI is input as 4HZERO, the absorbed solar or the 
absorbed infrared fluxes, respectively, will be set to 0.0. 

The reading of solar or infrared gray body factors will also be 
bypassed so that unused gray body factors need not be calculated. 
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RELATED INFORMATION: 


If; a comprehensive printouc of absorbed fluxes is desired, che FORTRAN 
statement AQPRNT “ YES should appear prior to any L AQCAL card or any ORBCEN 
card (reference Section 4. 3. 7.1: Subroutine AQOATA). 


SUBROUTINE NAME: 


BUILDC 


PURPOSE : 

This subroutine is used to define as problem geometry all nodes and 
surfaces identified with a Block Coordinate System. BUILDC is the first call 
to define a new configuration. 

VARIABLE NAME : 

BCSNAM is a block coordinate system name consisting of up to 6 
characters, (alphanumeric , beginning with an alphabetic character) 

CONFIG is a Hollerith name identifying the current active configuration. 

RESTRICTIONS : 

Must be called prior to any Subroutine ADD calls within a step. BCSNAM 
must be ALLBLK, or a block coordinate systems name as defined in surface 
data. CONFIG must be input as a Hollerith string of up to six characters. 

For example, 5HSHUTL. 

NOTE: If BCSNAM * ALLBLK, all surfaces in the surface data block become 

problem geometry. If CONFIG - 0 in the first call to BUILDC, the 
configuration name defaults to the run model name input in the options 
data block. CONFIG must be input in subsequent calls to BUILDC. 

CALLING SEQUENCE : 

CALL BUILDC (BCSNAM. CONFIG) 


D-7 


RELATED INFORMATION: 


Sequences of calls to BUILDC and ADD may be accomplished with one card 
(reference Section 3.3«9.4: Build Option), formatted as follows: 

CCl CC7 

BUILD FIG, BLKl , BLK2 , BLK3 

This is equivalent to the sequence: 

CC7 

CALL BUILDC(BLK1,3HFIG) 

CALL ADD(BLK2) 

CALL ADD(BLK3) 

Note that the configuration name, FIG, must begin to the right of card column 
6« If a continuation card is required to list all the BCS names involved, 
some character is required in CC6 of each continuation card. A BCS name may 
not be split between cards. 
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SUBROUTINE NAME: 


CHGBLK 


PURPOSE: 


This subroutine sllows the user to chsnge block coordinste system 
psrsmeters where: 


BCSNAM block coordinste system to be changed 

TX - translation slong CCS X*axis 

TY - translation along CCS Y-axis 

TZ - translation along CCS Z-axis 

IROTX - order X rotation is to be performed (1,2,3) 

IROTY - order Y rotstion is to be performed (1,2,3) 

IROTZ - order Z rotation is to be performed (1,2,3) 

ROTX - angle of rotation about CCS X-axis 

ROTY - angle of rotation about CCS Y-axis 

ROTZ - angle of rotation about CCS Z-axis 

RESTRICTIONS: 


1. TX, TY, TZ, ROTX, ROTY, ROTZ must be floating-point numbers. 

IROTX, IROTY, IROTZ must be integers, 1, 2, or 3 

2. Must be called prior to the applicable BUILD Card. The Header BCS 
Data on the geometry data file is overwritten with the new data 
from the call to CHGBLK. Thus, another call to CHGBLK is required 
to return a BCS to the state it was entered originally. 

3. CHGBLK does not change the configuration. To implement the 
change, a BUILD card with a new configuration name must follow. 

One BUILD card will implement a series of CHGBLK calls. 


CALLING SEQUENCE : 

CALL CHGBLK (BCSNAM, TX, TY, TZ, IROTX, IROTY, IROTZ, ROTX, ROTY, ROTZ) 
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SUBROUTINE NAME: 


CMDATA 


PURPOSE: 


This subroutine is used to define perimeters used by CMCAL in combining 
fora factors according to correspondence data. 


variable 

Names 


Options 

Default Value 

NFIGFF 

- Configuration name for 

unconbined 

N/A 

Current Config. 


fora factor access 



Nane 

NFICCO 

* Configuration name for 

form factor 

N/A 

Current Config. 


correspondence data access 


Name 

NFFTYP 

• Form factor type flag 


2HFF, 2HIF 

2HFF 


Options: 

2HFF - direct fora factors from FFCAL or NFFCAL will be combined 
2HIF - image factors from RBCAL or RTCAL will be combined 
lAUTOC - Flag to apply auto combining data 3HYES, 2HN0 3HYES 

FFPRNT - Print flag for combined form factors 3HYES,2HN0 3HYES 


NOTES 

If not called prior to a CMCAL execution, default values are used. 
CALLING SEQUENCE : 

CALL CMDATA ( NFIGFF, NFIGCO.NFFTYP, I AUTOC, FFPRNT) 

RELATED INFORMATION: 


See Section 3, 3. 8: Correspondence Data 


SUBROUTINE NAME: 

DICOMP 


PURPOSE: 

Ibis subroutine is 
execution. 

used to define logic used in subsequent DICAL 

DEFINITIONS: 

Variable Names 

Options 

Default 

ISOLFL - fol.r flux 

a. 4HZER0 - zeros out solar 
flux for all nodes 

b. 0 (integer) - results 
in computation of solar 



fluxes 

c. STEPN (integer step 
number) * stuffs solar 
fluxes from STEPN into 
current step storage 

0 (compute) 

lALBFL - albedo flux 

compuCe/stuff 

flag 

Same as for ISOLFL 

0 

IPLA/L - planetary flux 
coopuCe/sCuf f 
flag 

RESTRICTIONS: 

Same as for ISOLFL 

0 


Cannot zero albedo flux if planetary is calculated (and vice versa). 


D-Il 


NOTES: 


1. Compuct/scuf f flags arc overridden by the planet shadow. 
Nonzero solar or albedo fluxes will never be stuffed into 
storsge for a point within the planet shadow. 

2. Failure to call DICOMP prior to a OICAL execution results in 
default values for all three flags. 

CALLING SEQUENCE : 

CALL DICOMP (ISOLFL, lALBFL, IPLAFL) 
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SUBROUTINE NAMES: 


DIDTl, DIDTIS 


PURPOSE: 


Calls to define direct irradiation shadowing and accuracy parameters 
and to compute heat source position vectors from true anomaly or time. 

DEFINITIONS: 


Variable Names 


Default Values 


Dr.iOSH - shadow/no shadow flag (Options: 4HN0SH, 

4HSHAD,3HLSS*) 


4HSHAD( shadow 
calculations not 
bypassed) 


DIACC - element selection accuracy factor for node/planet 0.25 
form factors 


DIACCS - element selection accuracy factor for shadowing 0.10 
calculations 


TRUEAN “ true anomaly. If TIMEPR is entered TRUEAN will be None 
computed 

NSPFF - step number refeience to obtain node-planet foim 0 (new form 

factors previously saved in reference factors computed) 

step number 

TIMEPR - time None 

DIPNCH - flux punch flag (Options: 3HYES , 2HNO, 4HTAPE**) 2HNO 

ISFAC - flag to write shadow factor on RSO for printout 2HN0(CDC) 

on subsequent runs (Options: 3HYES, 2HN0) 3HYES(UNIVAC) 


RESTRICTIONS: 


Either TRUEAN or TIMEPR must be defined in call. 

CALLING SEQUENCE : 

CALL DIDTl (DINOSH, DIACC, DIACCS, TRUEAN, NSPFF, TIMEPR, DIPNCH, ISFAC) 
CALL DIDTIS (TRUEAN, NSPFF, TIMEPR, DIPNCK, ISFAC) 

RELATED INFORMATION: 


The statement ITRC71 « 2HON prior to a call to the DICAL segment will 
print for each node the surface numbers considered as possible shadowers in 
solar flux calculations (not available on CDC). 

NOTE : 

* 3HLSS option allowed only if entire configuration consists of surface 
types ELEM and/or TAPE. 

** Writes 3CD output to USERl file in Flux Data Block input Format. 




Sla.xJUTINE NAHES: 


DIDT2, DIDT2S 


PURPOSE : 

Calls to define direct irradiation shadowing and accuracy parameters 
and to compute heat source position vectors from look angles. 

DEFINITIONS : 

VARIABLE NAMES 

DINOSH - shadow/no shadow flag (Options: 4KN0SH, 4HHAD) 

DIACC - element selection accuracy factor for node/planet 
form factors 

DIACCS - element selection accuracy factor for shadowing 
calculations 

NSPFF - step number reference to obtain node - planet form 
factors previously saved in reference step number 

DIPNCH - flux punch flag (Options: 3HYES, 2HN0, 4HTAPE*) 

ISFAC - flag cO write shadow factor on RSO for printout 
on subsequent runs (Options: 3HYES, 2HN0) 

SUNCL, SUNCO - look angles to sun (clock, cone) in the VCS.* 

PLCL, PLCO “ look angles to planet (clock, cone) in the VCS.** 

TIMEPR - present time 

ALT - spacecraft altitude 


DEFAULT VALUES 

4HSHAD (shadow 
calculations not 
bypassed) 

0.25 

0.10 

0 (new form 
factors computed) 

2HNO 

2HNO(CDC) 

JHYES(UNIVAC) 
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* Allowable ranges of SUNCL, PLCL are 0 to 360 degrees. 
Allowable ranges of SUNCO, PLCO are 0 to 180 degrees. 

RESTRICTIONS: 


^nese calls must be preceded by a call to ORBITl or 0RBIT2. The 
purpose is to define the orbit-centered body and set the variables PRAD, SOL, 
PALB, WDS and WSS. A call to ORIENT is required if the CCS and the VCS are not 
coinc ident. 

Subroutine SPIN should not be used with DIDT2 or DIDT2S. 

CALLING SEQUENCE : 

CALL DIDT2 (DINOSH, DIACC, DIACCS, NSPFF, SUNCL, SUNCO, 

PLCL, PLCO, TIMEPR, ALT, DIPNCH, ISFAC) 

CALL DIDT2S (NSPFF, SUNCL, SUNCO, PLCL, PLCO, TIMEPR, ALT, DIPNCH, 

ISFAC) 
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SUBROUTINE NAME: 


DIDT3, DIDT3S 


PURPOSE: 


These subroutines are used to define and update direct irradiation 
parameters when using the planet surface option. 


DEFINITIONS: 


Variable Names 

Default Valud 

DINOSK - shadow/no shadow flag (Ref. DIDTl) 

DIACCS - element selection accuracy factor for shadowing 
ITOD - time of day (military time), integer (e.g., 1435) 
DIPNCH - flux punch/no punch flag (Ref. DIDTl) 

ISFAC - flag to write shadow factors on RSO (Ref. DIDTl) 

4HSHAD 

0.1 

None 

2HNO 

2HNO(CDC) 

3HYES(UNIVAC) 

RESTRICTIONS: 



Must be preceded by a call to subroutine SURFP. 
CALLING SEQUENCE : 

CALL DIDT3(DIN0SH,DIACCS,IT0D,DIPNCH,ISFAC) 

CALL DIDT3S(IT0D, ISFAC) 


NOTES : 

i. Use the statements TIMEPR = DAWN and TIMEPR = DUSK in the operation data 
to set current time to sunrise time and sunset time, respectively. 

DIDT3 and DIDT3S CANNOT oe used with DAWN or DUSK as the first 
argument. The sequence: 

DIDT3 (4HN0SH, .05,0,0,0) 

TIMEPR = DAWN 

is required to set DINOSH, DIACCS and TIMEPR is the time desired 
is DAWN. 


D-17 


SUBROUTINE NAME: 


DIREAD NOT AVAILABLE IN CDC VERSION 


PURPOSE: 


This subroutine is used to expedite and decrease core storage 
requirements when reading DI information on RSI tapes. 

RESTRICTIONS : 

May be called in lieu of L DICAL on restart runs only when the DI 
pseudo-file is known to be complete and if no overrides from the flux data 
block are desired. 

CALLING SEQUENCE : 

CALL DIREAD 

RELATED INFORMATION: 


When IFO (fifth argument) is set to DIR on the ORBGEN card, all L DICAL cards 
normally generated by the ORBGEN call will be replaced by calls to DlilEAD. 
(Ref. Sec. 3. 3.9.2: ORBGEN option) 
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SUBROUTINE NAME: 


DISTAB 


PURPOSE 


This subroutine allows the user to control all aspects of the way 

shadow factor tables are used in the calculation of solar, albedo, and 

planetary fluxes. 

VARIABLE NAME : DESCRIPTION DEFAULT VALUES 

TOLS Tolerance used in interpolation of 0.5 

shadow factor tables for solar flux 
calculations 

TOLP Tolerance used in interpolation of 0.75 

shadow factor tables for albedo and 
planetary flux calculations 

NSAR Array of node numbers for which solar NONE 

fluxes are not to be calculated 
using shadow tables. 

NPAR Array of node numbers for which albedo NONE 

and planetary fluxes are not calculated 
using shadow tables. 

ISFL Solar flux shadow factor flag. Options: 3HYES 

2HN0 - shadow factor tables will 
not be used for solar flux 
calculations 

3HYES - NSAR and TOLS control the 

use of shadow factor tables 
in solar flux calculations 
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IPFL 


3HYES 


Albedo and planetary flux shadow factor 
flag: 

Options : 

2HN0 - shadow factor tables will 
not be used for albedo and 
planetary flux calculations 
3HYES - NPAR and TOLP control the 

use of shadow factor tables 
in albedo and planetary flux 
calculations 


CALLING SEQUENCE : 

CALL DISTAB (TOLS, TOLP, NSAR, NPAR, ISFL, IPFL) 
RELATED INFORMATION: 


See section 4. 3. 5. 9 p. 4 - 41. 
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SUBROUTINE NAMES: 


DITTP, DITTPS 


" PURPOSE : 

These subroutines read data from a trajectory tape and define 
spacecraf t/beat source parameters through subroutine DIDT2* DITTP is called 
initially in order to define planetary parameters and position the tape for 
subsequent time points* DITTPS is used to update time and attitude/position 
data* 


DEFINITIONS : 

Variable Names Options 


TIME - mission time 

ITYPE - identifier for special event record 

PLANAM - name of orbit-centered planet (if applicable) 

(ref ORBITl) 

IDWDN - number of word FIDEN in identification record 

FIDEN - file identification word 

NTIM - number of time word in information record 

NTYPE - number of word ITYPE in information record 

NCLPL - number of word containing clock angle-to- 

planet vector 

NCOPL - number of word containing cone angle-to- 
planet sector 

NCLS - number of word containing clock angle-to- 
sun vector 

NCOS - number of word containing cone angle-to- 
sun vector 

NRAD - number of word containing planet center-to- 
spacecraft distance 

NWOR - number of words in tape record 

ALTMF - multiplying factor to convert units of NRAD 
word to feet 


Real no. 

Integer 

Hollerith 

Integer 

Hollerith 

Integer 

Integer 

Integer 

Integer 

Integer 

Integer 

Integer 

Integer 
Real no. 
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Variable Narees (continued) 


Optiona 


IBOD - one-body/ two-body flag integer 

0 - One-body tape 

1 - Two-body tape, use body 1 

2 - Two-body tape, use body 2 

DIPNCH - Punch/no punch flag for orbital flux output Hollerith 

RESTRICTIONS ; 

a. Calls to DITTPS to update time and type can be made only after a 
call to DITTP is in effect. 

b. The TIME argument in DITTPS calls must be greater than any pre- 
viously defined TIME argument until the tape is repositioned 
through a call to DITTP. 

RELATED INFORMATION : 

See Section 4. 3. 3. 8: Subroutine DITTP and DITTPS 

CALLING SEQUENCES : 

CALL DITTP (TIME, ITYPE, PLANAM, IDWDN, FIDEN, NTIM, NTYPE, NCLPL, 
NCOPL, NCLS, NCOS, NRAD, NMOR, ALTMF, IBOD, DIPNCH) 

CAi-L DITTPS (TIME, ITYPE) 
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SUBROUTINE NAME: 


DRDATA 


PURPOSE : 

This subroutine is used to define parameters used by DRCAL in computing direct 
irradiation with real body effects. 

DEFINITIONS : 


Va riable 

Names 

Options 

Default Values 

NSTPDI 

- step number for flux data 

Integer 

Current step no. 


access 



DIACCS 

- accuracy parameter for 

Reference DIDTl 

0.1 


flux shadowing 




NOTES: 


If not called prior to DRCAL execution, default values are used. 


Calling Sequence : 


CALL DRDATA (NSTPDI, DIACCS) 
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SUBROUTINE NAME; 


FFDATA 


PURPOSE : 

This subrouCine will define peramecers used in FFCAL if other chan 


default values are used. 
DEFINITIONS: 



Variable Names 

Default 

Values 

FFACC - 

orientation accuracy factor 

0.05 


FFACCS - 

shadowing accuracy factor 

0.1 


FFNOSH - 

shadowing override flag (4HN0SH, 4HSHAD) 

4HSHAD 


FFRATL - 

distance/area ratio factor 

15.3 


FFMIN 

eliminate small form factors 

l.E-6 


FFPRNT - 

flag to print form factors (3HYES,2HNO) 

3HYES 


FFPNCH - 

flag to punch form factors (3HYES,2HNO,4HPALL*. 
4HTAPE**) 

2HN0 


FFNAC 

node array check flag (3HYES,2HNO) 

3HYES 


IFFSPC - 

flag to calculate form factors to space directly 
Options: 

0 - form factor to space not caculated directly 
Integer space node no- - form factor to space 
calculated directly 

0 


IFFDT 

Configuration name for form factor data 
block reference 

Current 

name 

conf ig 


* 4HPALL will punch all form factors (UNIVAC version) 

** Writes form factor output to the USERl file in form factor data block 
format (UNIVAC version). 


RESTRICTIONS: 



NOTES: 


Example: CALL FFDATA (0., 0., AHNOSH, 0, l.E-3, 0, 3HYES, 3HYES,0,O) 

Results in no shadowing computations, form factors below 0.001 ignored, 
form factors printed and default values used elsewhere. If value 
passed is zero, default value assumed. 

RELATED INFORMATION ; 

1. The statement IFFSHO • 2HN0 prior to a call to the FFCAL link will 
bypass Form Factor computations to shadower only nodes. IFFSHO 
defaults to 3HYES. 

2. FFPNCH defaults to punch calculated form factors if RSO tape is 
not specified* 

3. The statement FFZERO ■ DV, prior to a call to the FFCAL or NFFCAL 
links will set the entire matrix to the Specified Data Valve (DV) 
and over-ride the form factor * Area matrix on the RSI file. It 
will not, however, override the Form Factor Data block. 

4. The statement NFFSET ■ DV prior to a call to the FFCAL or the 
NFFCAL link will direct the restart file (RSI/RSO) read/write 
operations (reference table 4 - I p. 4 - 12) to read and/or write 
one set of form factors only (ir and solar are the same) or two 
sets (ir and solar form factors may differ because of different 
surface transmissivities in the two wavebands). 

5. The statement ITRC72 » 2H0N before FFCAL cr NFFCAJ e:ecution will 
result in a list, concurrently with form factors, of all possible 
l.ii mode shadowers by node numbers for each node pair. A better 
s.cernative to this is to abtain the list of possible shadowers 
independent of Che FFCAL or NfFCAL execution by a call to 
subroutine PFFSHD. See section 4.3.3. / and Appends'. D. 

CALLING SEQUENCE : 

CALL FFDATA (FFACC, FFACCS , FFNOSH, FFRATL, FrMIN, FFPRNT, FFPNCH, 
FFNAC, IFFSPC, IFFDT) 
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SUBROUTINE NAME: 


FFNDP 


PURPOSE: 


This subroucinc is used co obcsin s node nunber srrsy, punched on cards 
in format used in fora factor, flux data, and Shadow Factor data blocks. 


RESTRICTIONS; 


Call not valid prior to geometry definition. (BUILD card). 


CALLING SEQUENCE : 
CALL FFNDP 
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SUBROUTINE NAME: 


FFREAD 


NOT AVAILABLE ON GDC VERSION 



PURPOSE 

This subroutine is used to expedite and decrease core storage 
requirements when reading of form factor information on restart tapes* 

RESTRICTIONS : 

May be called in lieu of L FFCAL or L NFFCAL on restart runs only when 
the form-factor pseudo-file is known to be complete and if no over-ride/recomp 
information is desired from the form factor data block. 


CALLING SEQUENCE: 


C/vLL FFREAD 
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SUBROUTINE NAME: 


GBAPRX 


PURPOSE : 

This subroutine calculates gray-body radiant interchange factors using 
an approximate relationship and stores the results in data storage* Uses form 
factors and optical properties stored under current configuration name. 


Argument Name Description 


Options Default 


GBWBND 

NFIGFF 

NFFTYP 


NOTE: 


Waveband definition 

2HIR, 3HS0L 

4HB0TH 

name 

4HB0TH 


Conf igurat ion name for 


Current Con- 

form factor access 


fig. Name 

Fora factor type to be 

2HFF, 2HCM 

Last type calcu- 

used in GB calculations 


lated under CFIGFF 


1. Input zero for default action. 

2. Gray body factor computed according to: 

2F i j = Fi j«i€ j 

where: Fij * form factor from i to j 

*i = infrared or solar absorptivity, i. 
•j * infrared or solar absorptivity, j 


RELATED INFORMATION: 


See Section 4. 3. 6. 2: Approximate Radiant Interchange Factors - 

Subroutine GBAPRX 


RESTRICTIONS : 

Use of this routine shou,. oe 
nodes with low reflectivities 
direct components of the gray 
reflections are ignored. 


limited to configurations made up of 
(high absorpt ivit ies ) since only the 
body factors are calculated and all 
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CALLING SEQUENCE : 


CALL GBAPRX (GBWBND, 6HNFIGFF, NFFTYP) 
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SUBROUTINE NAME: 


GBDATA 


PURPOSE 


Defines parameters used by segment GBCAL in computing a gray^body 
factor matrix. Uses form factor * Area matrix stored under configuration 
name, and the specified optical properties. 

DEFINITION : 

Variable Names Default Value 

GBWBI4D - Waveband definition name (2HIR, 3HS0L, 4HB0TH) 4HB0TH 

NFIGFF - Configuration name for form factor access Current Config. 

name 


NFFTYP - Form factor type to be used in GB calculations 
Options: 2HFF, 2HRB, 2HCM 


Last type cal- 
culated under 
NFIGFF 


CALLING SEQUENCE : 

CALL GBDATA (GBWBND, 6HNFIGFF, NFFTYP) 
RESTRICTIONS: 


1. GBDATA roust be called prior to calculating gray body factors. 

2. Do not use a GBWBND of 3HS0L or 4HB0TH when used in conjunction 
with a call to ADSURF. 


SUBROUTINE NAME: 


LIST 


PURPOSE: 

This subroutine is used to obtain a printed listing of data on BCDOU 
and/or USERl tapes. 

Variable Names Options Default 

NAMEF - Name of tape to be listed 4HE0TH, NUSERl , 4HB0TH 

NBCDOU 

N - Number of files to be listed Integer, 3HALL None 

NOTE: 


1. Call valid after writing data to BCDOU from RCCAL, RKCAL and/or 
QOCAL, or after writing data to USERl from FFCAL and/or DICAL. 

CALLING SEQUENCE : 

CALL LIST (NAMEF, N) 

RESTRICTIONS : 

Do not call Subroutine LIST until all writing to NAMEF Tape/file has 
been completed. 


SUBROUTINE NAME; 


MODAR 


PURPOSE : 

This subroutine changes the area of a designated node, or changes ^he 
area of all currently active nodes by use of a multiplier* 


Argument Name 

Description 

Options 

Default 

ND 

Node Number 

a. Any active node 

None 


designator 

number (integer) 




b. 3HALL 


AR 

Desired value 

a. Floating-point 

None 


for area 

data value 




b. Area multiplier^ 



(3HALL option only) 


NOTE : 

1. When ND ■ 3HALL, all active node areas are modified according to: 
AREA » AREA^AR* 

RESTRICTIONS : 

1. Call not valid prior to geometry definition tlirough calls to 
BUILDC and ADD. 

2. MODAR calls are cancelled by BUILD card or a subsequent BUILDC/ADD 
Sequence. Areas revert to those in surface data. 

RELATED INFORMATION: 


See Appendix D - Subroutine NODDAT. Also see Section 4. 3.8.1: 
Subroutine MODAR. 

CALLING SEQUENCE : 

CAi.L MODAR (ND, AR) 
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SUBROUTINE NAME; MODPR 


PURPOSE; 


This subroutine modifies the diffuse infrared enmissivity and/or the 
diffuse solar absorptivity of a designated node. 


Argument Name Description 


Options 


Default 


ND 


Node number Any active None 

designator node number 


ALPHA 


Diffuse solar a. 0. < DV < 1. None 

absorptivity 

b. DV < 0. 


EMISS Diffuse IR 

emissivity 


£. 0. ^ DV ^ 1. None 


b. DV < 0. 


NOTE; 


1. If ALPHA <0. or EMISS < 0., current values are not changed. 
RESTRICTIONS ; 

1. Call not valid prior to geometry (definition through calls to BUILDC 

and ADD. 

2. MODPR calls are cancelled by BUILD card, or a subsequent BUILDC/ADD 
sequence. Properties revert to those in surface data. 
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CALLING SEQUENCE ; 

CALL MODPR (ND, ALPHA » EMISS) 
RELATED INFORMATION; 


See Subroutine NODDAI -* Page D**42 
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SUBROUTINE NAME: NODPRS 


PURPOSE : 


This subroutine modifies Che solar and/or Infrared specular 
reflectivity of a designated node. 


Argument Name 

Description 

opt 

ions 

Default 

ND 

Node number 
designator 

Any active 
node number 

None 

SPRS 

Specular reflectivity, 
solar 

a. 

0. DV ^ 1. 

None 

SPRI 

Specular reflectivity, 
infrared 

b. 

a. 

DV< 0.^ 

0. ^ DV ^ 1. 

None 



b. 

DV < 0.^ 



NOTES: 


1. If SPRI < 0. or SPRS < 0., current values are not changed. 

RESTRICTIONS : 

1. This call applicable only to nodes defined as specular reflectors in 
the surface data block. Nodes on ^he same surface do not 
necessarily have to have the same specular reflectivity. 

2. Call not valid prior to geometry definition through calls to BUILDC 
and ADD. 

3. MODPRS calls are cancelled by a subsequent BUILD card or BUILDC/ADD 
sequence. Properties revert to those in surface data. 
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CALLING SEQUENCE: 


CALL MODPRS (ND, SPRS, SPRl) 
RELATED INFORMATION; 


See subrojcine NODDAT • Page D-42 
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STJbR0UTI^7E NAME: MODSHD 


PURPOSE; 


This subroutine modifies the SHADE/BSHADE flags for a designated 


surface. 



Argument Name 

Description 

Options 

ISR 

Surface number 
designator 

Any active 
surface number 

SHADE 

"Can shade" flag 

FF, DI, BOTH, 
NO, 0^ 

ESHADE 

"Can be shaded" flag 

FF, DI, BOTH, 
NO, 0^ 


Default 

None 

None 

None 


NOTES: 


1* If SHADE or 5SHADE data values are zero, their values are not 
changed • 

2. Shade flag changes affect entire surface. 

3. MODSHD calls are cancelled by a subsequent BUILD card or BOILDC/ADD 
sequence* 
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RESTRICTKWS t 

Call not valid prior to geonctry definition through calls to BUILZX: and 

ADD. 


Call not applicable to shadower-only surfaces. 

Calls to MODSHD are cancelled by a subsequent BUILD card or BUILDC/ADD 
sequence. Properties revert to those in surface data. 

CALLING SEQUENCE ; 

CALL MODSHD (ISR, SHADE, BSHADE) 
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i 

\ SUBROUTINE NAME i MODTR 

PURPOSE ; 

This tubroucine modifies the soler end/or infrared transmissivity of a 
designated surface. 


Argument Name 

Description 

Options 

Default 

ISR 

Surface number 

Any active 

None 


designator 

surface number 


TRANS 

Solar transmissivity 

a. 0. ^ DV < 1. 

None 



b. DV < 0.^ 


TRANI 

IR transmissivity 

a. 0. ^ DV < 1. 

None 



b. DV < 0.^ 



1. A negative TRANS or TRANI should be used if two TRASYS surfaces are 
input for one semitransparent body. This avoids having the shadow 
factors multiplied by the SQUARE of the Transmissivity. The pro- 
gram will use the SQUARE ROOT of the Transmissivity if the user en- 
ters the transmissivities with a negative sign (Ref. Section 4 

3. 3. 3. 8: Properties Data). 

2. Transmissivity changes affect entire surface. 
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RESTRICTIONS: 


Call not valid prior to jeomatry definition through calls to 3UILDC and 

ADD. 


Calls to MODTR are cancelled by a subsequent BUILD Card or BUILDC/ADD 
sequence. Properties revert to those in surface data. 

CALLING SEQUENCE ; 

CALL MODTR (ISR, TRANS, TRANI) 

RELATED INFORMATION ; 

See Appendix D; Subroutine NODDAT 
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SUBROUTINE NAMES; NDATA, NDATAS 


PURPOSE ; 


These subroutines may be called prior to a call to the node plotter 
segment to define optional views and miscellaneous parameters where: 


Parameter 

Description 

Options* 

Default 

NV 


View number 

1-6 

1 

VU 


View 

3HALL, 3H3-D 
IHX, IHY, 1H2, 
3HGEN 

3HALL 

SCL 


Scale 

Floating-point no. 

Automatic scale 

NACT 


Flag for plotting ac- 
tive side of arrows 

2HN0, 3HYES 

2HN0 

ISHO 


Flag to plot shadower- 
only surfaces 

2HN0, 3HYES 

2HN0 

S£LN 


Name of array contain- 
identification numbers 
of nodes to be selectively 
plotted 

Array naL® 

Plot all nodes 

TIT 


Array name of plot title 

Array name (array 
length 66 charac- 
ters max.) 

Uses job 
title 

IROTX, 

IR0T2 

IROTY 

Order of rotations (for 
VU » 3HGEN) 

1,2,3 (any order) 

1,2,3 

ROTX, 

RDTZ 

ROTY 

View rotations (for VU 
» 3HGE^’^ 

Real no. 

0.0, 0.0, 

0.0 


♦Input zero for default action 
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NOTE: 


The NV parameter allows the user to define up to 6 plot operations 
will be executed with one NPLOT segment call. Later in execution, 
(after a geometry change, for instance), he can execute the same 6 
operations or change one or more by reference to the appropriate NV 
before his NPLOT call. 

RESTRICTIONS: 


None 


CALLING SEQUENCE : 

CALL NDATA (NV, VU, SCL, NACT, ISHO, SELN, TIT, IROTX, IROTT, IROTZ 
ROTX, ROTY, ROTZ) 

CALL NDATAS (NV, VO, SCL, NACT, ISHO) 


that 
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I 

V_ 

SUBROUTINE NAME : NFDATA 

PURPOSE : 

This subroutine defines the parameters for the NFFCAL segment if other 
tnan default values are desired. 

DEFir 0^: 

Variable Names De fault 


NELCT - total element count on a node 50 

U6 through 200 allowed) 

FFNOSH - shadowing override flag (4HN0SH, 4HSKAD) 4HSHAD 

FFMIN - eliminate small form factors l.E-6 

FFPRNT “ flag to print form factors (3HYES, 2HN0) 3HYES 


FFPNCH - flag to punch form factors (3HYES, 2ilN0, 4HPALL*, 2HN0 
4H'1APE**> 


FFNAC - node array check flag (3HYES, 2HN0) 

IFFSPC - flag to calculate form factors to space 

directly ^activated by inputting the space 
node number^ 


IFFDT - Configuration name for form factor data 
block reference 


3HYES 


current config 
name 


* 4HPALL will punch ail form factors CUNIVAC version) 

** Writes form factor output to USER! tile in form factor data block 

format lUNIVAC version) 
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CALLING SEQUENCE : 

CALL NFDATA (NELCT, FFNOSH, FFMIN, FFPRNT, FFPNCH, FFNAC, IFFDT) 

RELATED INFORMATION ; 

1. The statement IFFSHO * 2HNO prior to a call to the FFCAL link will 
bypass Form Factor computations to shadower only nodes. IFFSHO 
defaults to 3HYES. 

2. FFPNCH defaults to punch calculated form factors if RSO tape is 
not specified. 

3. The statement FFZERO = DV, prior to a call to ihe FFCAL or NFFCAL 
links will set the entire matrix to the Specified Data Valve iDV) 
and override the form factor * Area matrix on the RSI tile. it 
will not, however, override the Form Factor Data block. 

4. The statement NFFSET = DV, prior to a call to the FFCAL or the 
NFFCAL link will direct the restart file ‘RS1/R30) read/write 
operations preference table 4 - I p. 4 - 12) to read and/or write 
one set of form factors only Pir and solar are the same) or two 
sets (iiT and solar form factors may differ because of different 
surface transmissivities in the two wavebands). 

5. The statement ITRC72 « 2H0N before FFCAL or NFFCAL execution will 
result in a list, concurrently with form factors, of ail possible 
intermode shadowers by node numbers for each node pair. A better 
alternative to this is to oDtain the list of possible shadowers 
independent of the FFCAL or NFFCAL execution by a call to 
subroutine PFFSHD. See section 4. 3. 3. 7 and Appendix D. 
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SUBROUTINE NAME: NODDAT 


PURPOSE; 

This routine may be called at any time from the operations data block 
to print nodal areas and surface optical properties. This routine is 
particularly useful following calls to the '*MOD" routines. 

RESTRICTIONS ; 

May be called at any time after a model has been defined by calls to 
^'BUILDC*' and ”ADD", or by use of the "BUILD" card. 

CALLING SEQUENCE; 


CALL NODDAT 
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SUBROUTINE NAMES: ODATA, CHJATAS 


PURPOSE; 


These subroutines nay be called prior to a call to the orbit plotter to 
define optional v' evs and miscellaneous parameters where: 


Parameter 

Description 

Options* 

Default 

NV 

View number 

1-6 

1 

VU 

View 

3HALL, 3H3-D, 
4HBETA, 5HCIGMA, 
3HSUN, 3HGEN 

3HALL 

SCL 

Spacecraft size measured 
from CCS origin in plot 
frame dimensions 

Real no. 

Computed auto- 
matically 

SCLR 

Orbit radius in plot 
frame dimensions 

Real no. 

Computed auto- 
matically 

RPLN 

Planet radius in plot 
frame dimension 

Real no. 

1.4 inches 

TRUEAN 

True anomaly 

Real no. 

None 

TIMEST 

Time of periapsis 
passage 

Real no. 

None 

TIME 

Present time 

Real no. 

None 

SELN 

Name of array containing 
surface numbers to be 
selectively plotted 

Array name (array 
length 66 charac- 
ters, max.) 

Plots all 
surfaces de- 
fined as 
shadowers 
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Parameter Description 


Options* 


Default 


TIT 


Array name of plot title Array name 


Uses job title 


IROTX, Order of rotations 

IROTY, IROTZ (for view - 3HGEN) 


1,2,3 (any order) 1,2,3 


ROTX, ROTY, View rotations to rotate 

ROTZ plotter reference coor- 

dinate system (see Fig- 
ure 4-2 on P. 4-16) into 
user*s desired view. 


Real no. 


0 . 0 , 0 . 0 , 0.0 


*Input zero for default action 


The NV parameter allows the user to define up to 6 plot operations that 
will be executed with one OPLOT call. Later in execution (after a geometry 
change, for instance), he can execute the same 6 operations or change one or 
more by reference to the appropriate NV before this OPLOT call. 

RESTRICTIONS: 


Calls valid only after orbit has been defined. 


CALLING SEQUENCE : 

CALL ODATA (NV, VU, SCL, SCLR, RPLN, TRUEAN, TIMEST, TIME, SELN, TIT, 
IROTX, IROTY, IROTZ, ROTX, ROTY, ROTZ) 

CALL ODATAS (NV, VU, SCL, SCLR, RPLN, TRUEAN, TIMEST, TIME) 
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SUBROUTINE NAME: ORBITl 


PURPOSE; 


This subroutine defines spacecraft orbits in terms of classic orbital 
mechanics parameters and a celestial coordinate system. 

DEFINITIONS: 


Variable 

Names 


Default Values 

PNAME 

- 

name of orbit-centered body 

None 

ALAN 

- 

longitude of ascending node 

None 

APER 

- 

argument of peri focus 

None 

OINC 

- 

orbit inclination 

None 

TIMEST 

- 

time of periapsis passage, hours 

0.0 

HP 

- 

altitude at periapsis 

None 

HA 

- 

altitude at apoapsis 

None 

ECC 

- 

orbit eccentricity 

None 

SUNRA 

• 

right ascension of sun 

None 

SUNDEC 

- 

declination of sun 

None 

STRRA 


right ascension of star 

None 

STRDEC 

- 

declination of star 

None 


RESTRICTIONS ; 

None 


CALLING SEQUENCE ; 

CALL ORBITl (PNAME, ALAN, APER, OINC, TIMEST, HP, HA SUNRA, SUNDEC, 
STRRA, STRDEC) 

CALL ORBITl (PNAME, ALAN, APER, OINC, TIMEST, HP, ECC, SUNRA, SUNDEC, 
STRRA, STRDEC) 
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NOTES: 


PNAME options are as follows: 3HMER, 3HVEN, 3HEAR, 3HM00, 3HMAR, 3HJUP, 

3HSAT, 3HNEP, 3HURA, and 3HSUN. These names are used to key the follow- 
ing program variables: 

WDS - darkside infrared emissive power at planet surface 
PALB - planet albedo value (solar reflectance) 

PRAD - planet radius 

WSS - infrared emissive power at subsolar point 
SOL - solar "constant" at planet-sun distance 
GRAY - planet gravitational constant at surface 

The Seventh argument is tested for magnitude. If it is < 1.0, ECC is 
assumed. 

If it is > I.O 9 HA assumed. 

Execution of this subroutine defines the planetary shadow entry and 
exit points (Ref. Figure 4-7). 

RELATED INFORMATION: 


Refer to Figure 4.3 and Figure 4.4 for definition of terms. 
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SUBROUTINE NAME: 0RBIT2 


PURPOSE: 


This subroutine defines spacecraft orbits and sun/star position-orbit 
relationship in the orbit coordinate system. 

DEFINITIONS; 


Variable Names 


Default Values 


PNAME 

- 

name of orbit-centered body 


None 

CIGMA 

- 

clock angle - axis to solar vector projection 

None 

BETA 

- 

cone angle - axis to solar vector 


None 

CIGMAS 

- 

clock angle - axis to star vector 

projection 

None 

BETAS 

- 

cone angle - Z axis to star vector 
0 

projection 

None 

TIMEST 

- 

time of periapsis passage, hours 


0.0 

HP 

- 

altitude of periapsis 


None 

HA 

- 

altitude of apoapsis 


None 

ECC 

- 

orbit eccentricity 


None 

RESTRICTIONS: 





None 

CALLING SEQUENCE ; 

CALL 0RBIT2 (PNAME, CIGMA, BETA, CIGMAS, BETAS, TIMES! , HP, HA) 

CALL 0RBIT2 (PNA>1E, CIGMA, BETA, CIGMAS, BETAS, TIMES!, HP, ECC) 

NOTES; 

See subroutine ORBITl. This call not applicable to heliocentric orbits. 
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, RELATED INFORMATION ; 


Refer to Figures 4.3 and 4.S for definition of terms. 
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SUBROUTINE NAME: ORIENT 


PURPO SE: 


To define spacecraft orientation relative to orbital heat sources. 
DEFINITIONS: 


Variable Nanes Default Values 


TYPE - orientation type None 

IROTX - order of rotation about x-axis 1 

IROTY - order of rotation about y-axis 2 

IROTZ - order of rotation about z-axis 3 

ROTX - rotation about VCS x-axis to rotate VCS into CCS 0. 

ROTY ■* rotation about VCS y-axis to rotate VCS into CCS 0. 

ROTZ - rotation about VCS z-axis to rotate VCS into CCS 0. 


NOTt.S : 

TYPE options are as follows: 4HPLAN, 3HSUN, 4HSTAR, 4HTAPE. 

Individual default values obtained by passing zero. 

RESTRICTIONS: 


Not reconsended for use with DIDT2, DIDT2S. A call to ORIEOT oust 
precede a call to DlDTl or DIDTIS. 

RELATED INFORMATION: 


Refer to Figure 4.6 for definition of terms 
CALLING SEQUENCE: 


CALL ORIE;^ (TYPE, IROTX, IROTY, IROTZ, ROTX, ROTY, ROTZ) 
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SUBROUTINE HAME t PFFSHD 

PURPOSE ; 

This subroutine may be called by the user to obtain a listing of all 
possible shadowers (listed by node number) for each node pair considered in 
Form Factor calculations. 

RESTRICTIONS ; 

May be called at any time after a model has been defined by calls to 
"BUILDC" and "ADD", or by use of the "BUILD" card. 

CALLING SF.QUENCE ; 

Call PFFSHD 
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SUBROUTINE NAME : PLDATA 


PURPOSE: 


This subroutine defines peremeters necessary to execute the data 
plotter* 

DEFINITIONS: 


Variable Name 

Description 

Options 


Default 

IPLUNT 

Plot data flag 

Letter 1: 

A - Absorbed 

None 


(a conpoaite 
Hollerith word) 

Letter 

1 - Incident 
? - Fluxes 
R - Rates 




Letters 3, 

4, 5, & 6 (as 




required) 

S - Solar 





A - Albedo 





P - Planetary 



T - Total (Sum of SAP) 
ALL - ALL 

3HALL 3HALL 

Name of Array of step 
numbers. Steps do not 
have to be in any order 

3HALL 3HAM 

Name of Array of node 
number? 

PLCRVF Flag for curve- 3H\ES, 2HN0 3HYES 

fitting 


IPLSN Identifies steps A. 

to be plotted B. 


IPLNA Identifies nodes A. 

to be plotted B. 
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PLLABX 

Plot label X 

Array name (array length 
28 characters max.) 

Blanks 

PLIABY 

Plot label Y 

Array name (array length 
28 characters max.) 

Blanks 

PLTITl 

Plot label title 
line 1 

Array name (array length 
58 characters max.) 

Blanks 

PLTIT2 

Plot label title 
line 2 

Array name (array length 
70 characters max.) 

Blanks 

PLXMPF 

X-axis multiplying 
factor 

Real no. 

1.0 

PLYMPF 

Y-axis multiplying 
factor 

Real no. 

1.0 

PLCMB 

Plots output with 
correspondence ap- 
plied for current 
configuration name. 

3HYES, 2HN0 

2HN0 
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RESTRICTI(»IS: 


None 


NOTE; 


a. Examples of IPLUNI: 

3HARP; plots absorbed racesy planetary 
5H1FALL; plots all incident fluxes 

5HAFSAP; plots solar, albedo and planetary absorbed fluxes. 

b. Any set of dependent— and independent-variable data pairs may be 
plotted if IPLUNT ■ 1 and the data are written to disc/drum unit 1 in 
advance (reference Section 5.1.4). 

CALLING SEQUENCE ; 

CALL PLDATA (IPLONT, IPLSN, IPLNA, PLCROF, PLLABX, PLLABY, PLTITl, 
PLTIT2, PLXMPF, PLYMPF, PLCMB) 
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SUBROUTINE NAME; QODATA 


PURPOSE : 


This subroutine used to define the absorbed heat output 
obt( .xaed fron the subsequent QOCAL execution. 

DLFINITIONS ; 

Variable Names 


NSARRY - array of step numbers where absorbed Q data is 

stored. Any order allowed. Options: array name, 

3HALL. 

NTMARY - themcl analyser time array number (Q arrays num' 
bered consecutively from NTMARY 1) 

QOTAPE - BCDOU tape output flag. Options: 4HTAPE, 2HN0 

QOPNCH - punch output flag. Options: 3HPUN, 2HN0 


QOAMPF - area multipl; cation factor 

QOFMPF - energy multiplicatio factor 

QOTMPF - time multiplication factor 

QOTYPE - type of output flag. Options: 3HTAB for Q vs 

time tables, 2H.W for orbtial average Q data, 
4HB0TH for both 

NFIGCO - current configuration name for correspondence data 


*See Subroutine QOINIT 


format to be 

Devault Value 
3HALL* 

1 

2HN0 

3HPUN(CDC) 

2HN0(UMIVAC) 

1.0 

1.0 

1.0 

4HB0TH 

Current Conf. 
Name 
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RESTRICTIONS t 

Number of nodes in current geometry definition must be the same for 
all steps in NSARRY. 

NOTES : 

Sort is made to obtain monotonically increasing time array. Trapezoidal'-rule 
average made for orbital average heat tables. 

QOAKPF applies only to areas on thermal analyzer subroutine call output. 
QOFMPF applies only to heat flu* array output. 

QOTMPF applies to time array output and to value of period on subroutine call 
output. 

CALLING SEQUENCE : 

CALL QODATA (NSARRY, OTMARY, QOTAPE, QOPNCH, QOAMPF, QOFMPF, QOTMPF, 
QOTYPE, NFIGCO) 

( RELATED INFORMATION : 

See subroutine QOINIT 
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SUBROUTINE NAMEt QOINIT 


PURPOSE: 


This subroutine rewinds Che absorbed heat (NTQ) data storage file, 
thus providing user control of Che number of time points obtained with NSARRY 
■ 3HALL in subroutine QOD^A. This will make previously stored absorbed heat 
data inaccessible to the absorbed heat output (QOCAL) segment. 

CALLING SEQUENCE ; 

CALL QOINIT 

RELATED INFORMATION ; 

See Subroutine QODATA. 


D-59 


Revision 3 


SUBROUTINE NAME: RBDATA 


PURPOSE: 


This subroucin* it uttd to define pareMterc need by RBCAL in 
coaputing form fecCors with real-body radiation effects. 

Variable Names Default Value 



NFIGFF - 

Configuration name for form factor access 

Current con fig. name 

FFACC 

orientation accuracy factor 

0.05 

FFACCS - 

shadowing accuracy factor 

0.1 

FFRATL - 

distance/area ratio factor 

15.0 

FFPRNT - 

flag to print form factors (3HYES, 2HN0) 

3HYES 

NOTES: 




1. If not called prior to RBCAL execution, default values are used. 

2. Must utilize uncombined Form Factor. 

RESTRICTIONS : 

1. Specular surfaces for "RBCAL" oust be defined as flat surfaces 
(RECT, DISC, TRAP, or POLY) with one node per surface. 

2. Only first order specular reflections are considered in "RBCAL" 
calculations. 

3. Direct form factors must be calculated (using "FFCAL" or "NFFCAL") 
prior to image factor calculations using "RBCAL". 


CALLING SEQUENCE ; 


CALL RBDATA (NFICfF, FFACC, FFACCS, FFRATL, FFPRNT) 
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SUfiROUTINE NAME: RCDATA 


PURPOSE: 


This IS a usei'^cailed subroutine that defines the parameters used 
in RCCAL for the condensation and output of radiation conductors (RADKs). 

VARIABLE DESCRIPTION AND DEFAULT VALUES: 


Variable 

Descript ion 

Default Value 

NFiGGB 

Configuration name for gray body factor access 

Current Config 
Name 

RKPNCH 

Punch/no puncti flag* Options: 3HPUN, 2HN0 

3HPUN (2HN0 on 
Uni vac ) 

RKMIN 

Minimum value ot 'S’A/CA that will result in 
a valid RADK. RKMIN test is not made on con- 
ductors to the space node. 11 NERN is POSl- 
liVE the RKMIN test is applied to the sum of 
tliose connections discarded after the RFRAC 
requirement is satisfied. 

0.0001 

iRKCN 

Initial radiation conductor number 

1 

RKSP 

Flag for calculation of RADKs to spnee. 
Options: !>HSPACE, 2HN0 

2HN0 

IRKNSP 

Space node number 

32767 

SIGHA 

Stefan-Bol tzmann constant 

1.713E-9 

RKAMPF 

Area multiplying factor 

1.0 
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RKIAPE 


NFIGCO 


RFRAC 


RTOL 


N£RN 


IPRIME 


ISECND 


Flag to write RADKs to BCDOU tape* Options: 2HN0 

4HTAP£» 2UN0* See Subroutine LIST for Re- 
lated Information* 


Configuration name for correspondence data Current config* 

access name 


Significant radiation fraction: radiation 0*7 

conductors of a node to be left intact 
divided by the sum of the node conductors 

Percentage of BLAST Uast conductor value 0*99 

saved to meet RFRAC criterion)* Subsequent 
conductors will be saved it their values ere 
greater than RTOL * BLAST* 

Effective radiation node (.ERN) number* If None 

NERN is negative » all ERN conductors will 
be printed but not punched or written to tape* 


Array name for array of primary MESS node None 

numbers and special node numbers 

Array name for array of secondary MESS node None 

numbers 
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RESTRICTIONS ; 

RCDATA must be railed prior to RCCAL execution since all of the 
variables are not defaulted. 

IPRIME and ISECND arrays must be input in the array data block to 
specify MESS node pairs and special nodes. IPRIME contains a list of all 
primary MESS nodes and all special nodes in that order. ISECND contains a 
list of all secondary MESS nodes in IPRIME. 

CALLING SEQUENCE ; 

CALL RCDATA (NFIGGB, SKPNCH, PJCMIN, IRKCN, RKSP, IRKNSP, SIGMA, 
RKAMPF, RKTAPE, NFIGCO, RFRAC, RTOL, NERN, IPRIME, ISECND) 
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SUBROUTINE NAME: RKDATA 


PURPOSE: 


This Bubroutine defines perameters used in RKCAL for; output of 
radiation conductors (RAORs). 

Variable Names Default Value 


NFIGGB Configuration name for gray body factor access Current Config. 

RKPNQl Punch/no punch flag. Options: 3HYES, 2HN0 3HYES (CDC) 

2HN0 (UNI VAC) 

RKMIN Minimum value of 7 ^jA^/ f^Ai that 0.0001 

will result in a valid RADK. Test not applied 
to conductors to space nodes. 


IRKCN Initial radiation conductor number 1 

RKSP Flag for calculation of RADKs to space 2HN0 

Options: 5HSPACE, 2HN0 

IRKNSP Space node number 32767 

SIGMA Stefan-Boltzmann constant 1.713E-9 

RKAMPF Area multiplying factor 1.0 


RKTAPE Flag to write RADKs to BCDOU tape. Options: 2HN0 

4HTAPE, 2HN0. See Subroutine LIST for Re- 
lated Information 

NFIGCO Configuration name for correspondence data Current Config. 

access name 


name 
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HOTESt 


If noc called prior to RKCAL execution, default values will be 
aaaumed. Individual default valuea obtained by paaaing aero argu- 
mentt. 


CALLING SEQUEHCE t 

CALL RKOATA (MFIG6B, RKFNCH, RKNIN, IRKCN, RKSP, IRKHSP, SIGMA, 
RKAMPF, RKTAPE, NFIGCO) 
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SUBROUTINE WAME» 


RSMERG WOT AVAILABLE OW CPC VERSION 


PURPOSE! 


Thia aubroucinc la ua«d to awrgt fona factora tram aulcipl* raatart 

Capta. 


Variabla Daacription Optiona 

Namea 


Dafault 

Valua 


NUNIT - Raacart Unit Nana 


NRSI, NRSI2, NEMERC Nona 


MODLER - 

Configurtcion mm 
froa RESTART Capt 

Any 6 char, hollarith 

name 

INCRM - 

Node numbar increment/ 
dcc&eaant co make array 
on NUNIT agrae with 
currant noda array 

Integer Nc. 

IFLAG - 

Flag to racoapute 
anadovar-’only form 
factora 

0- ^recoaputa 

1- do not 

lEND 

FLAG to indicate 
final call to HSMERG 

3HYESp 2HN0 


3tIYES iapliaa last file 
haa been merged 



Nona 


C 


0 


3HNO 


RESTRICTIONS: 


1. The reatart tapaa suat ba called ao that firat aet of nodea on currant 
file are on the firat reatart tape and the aecond aet of nodea on current 
file are on the aacond reatart tape and ao on. Nodea which are not on a 
reatart tape mat appear in the current node array. 

2. The total number of reatart tapea that can be merged ia currently limited 
to the 3 named above. 

Calling aequence: 

CALL RSKERC (NUNIT, MODLER, INCRM, IFUC, TEND) 
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SUBmXlTINE HAME : RSTOFT 

PURPOSE t 

This subroucins is ussd co discontinus chs rssding of dots froa sn RSI 
taps during a raacart run. All oparacions folloving a call to this routine 
are perforacd aa though it was not a restart run, unless a call to subroutine 
RSTOM is made later. 

RESTRICTlOMS t 

Call valid only during a restart run froa an RSI tape. 

RELATED INFORMATIOM: 


Sec Section 4.3.9: Restart Control Subroutines 

CALLING SEQUEKCE i 
CALL RSTOFF 
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SUBROUTINE NAME: RSTON 


PURPOSE: 


This subroutine is used to re-establish the reading of data from an RSI 
tape following a call to RSTOFF. 

RESTRICTIONS: 


Call valid only during a restart tun from an RSI tape. 
RELATED INFORMATION: 


See Section 4.3.9: Restart Control Subroutines. 

CALLING SEQUENCE : 

CALL RSTON 


NOTE ; 

l*he judicious use of RSTCFF in conjunctin with RSTON allows the user to 
insert, delete, and/or recalculate any operations in his Operations 
Data Block. 
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SUBROUTINE NAME: RTDATA NOT AVAILABLE ON CPC VERSION 


PURPOSE: 


Subroutine to define pereneters used in the RTCAL segment. 


DEFINITIONS: 


Variable Names Description Options Default 


NELCT - total element count on a node 50 

(16 through 200 allowed) 

FFNOSH - shadowing override flag (4HN0SH, 4HSHAD) 4HSHAD 

FFMIN - eliminate small form factors l.E-6 

FFPRNT - flag to print form factors (3HYESt2HN0) 3HYES 

FFPNCH - flag to punch form factors (3HYES,2HN0,4HPALL*, 2HNO 

4HTAPE**) 

FFNAC - node array check flag (3HYES,2HNO) 3HYES 


NRAY - Equivalent number of (integer no.) 10000 

rays originated at each node. 

RAYMIN “ Minimum ray strength (real no.) .001 

(fraction of emitted 
strength) 


RESTRICTIONS: 


None 


CALLING SEQUENCE : 

CALL RTDATA (NELCT, FFNOSH, FFMIN, FFPRNT, FFPNCH, FFNAC, NRAY, RAYMIN) 
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SUBRCXJTINE HAME: SPIN 


PURPOSE: 


Subroucine Co define spececrafC spin rate, spin axis, and cime of 
beginning of spin. 

DEFINITIOWS; 


Variable Names 


Default Values 


CLOCK - clock angle - CCS x-axis to spin axis projection 0. 

CONE - cone angle - CCS z-axis to spin axis 0. 

RATE - spin rotation rate, revolutions/hour (positive 0. 

clock-wise as viewed along spin axis from origin) 

TRUANS - true anomaly where spin begins 0. 

SPNTM - time corresponding to TRUANS 0. 


RESTRICTIONS: 


Must be called subsequent to orbit definition through subroutines ORBITl 
or 0RBIT2. 

Subroucine SPIN cannot be used in conjunction with ORBCEN options INER and 


CIRP. 


r 


V 


NOTES : 


Revision 3 


a. The time et which spin begins may be defined either directly 
through SPNTM or through TRUAHf-. If SPNTM • 0, SPNTM is com- 
puted from TRUANS. 

b. Spinning may be stopped only by a call to subroutine SPIN with 
RATE ■ 0. and spin stop time or true anomaly defined. 

[ CALLING SEQUENCE ; 

CALL SPIN (CLOCK, CONE, RATE, TRUANS, SPNTM) 

I 

i 
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SUBROUTINE NAME ; SPINAV 

PURPOSE: 


This subroutine computes a tine weighted average of a specified set of 
incident and absorbed fluxes and stores the result in current step data 
storage. 

Variable Names Default Values 

NSARY - Name of an array of step numbers NONE 

RESTRICTIONS : 

Cannot be called from within a step contained in NSARY. 

The steps contained in NSARY must occur at monotonically increasing 
points in time 

CALLING SEQUENCE ; 

CALL SPINAV (NSARY) 
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SUBROOTINE NAKEl STFAQ 


PURPOSE: 


This subroutine stuffs known values of direct flux and absorbed heat 
from a previously executed step into current step data storage. It also 
defines tine of current step> either directly or from true anomaly. 

Variable Names Default Values 


TRUEAN - 

current true anomaly. 

degrees 

None 

TIMEPR - 

current time, houre 


None 

NSTP 

step number reference 

for known DI and AQ 

None 


values 




RESTRICTIONS ! 

Current geometry must agree with that of NSTP. 
CALLING SEQUENCE : 

CALL STFAQ (TRUEAN, TIMEPR, NSTP) 


NOTE! 


If TRUEAN. GE. 0. , time is computed from TRUEAN; otherwise TIMEPR is 
passed directly to current step data storage. 
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SUBROUTINE NAME ; SURFP 

PURPOSE : 

This subroucine defines peraaeCers for computing solar fluxes on a 
configuration located on a planet's surface. 


DEFINITIONS: 


Variable Names 


Default Values 


PNAME - name of planet (3HEAP, 3HMOO, 3HMAR) 


None 


ALAT 


location on planet surface, degrees of latitude None 


SUNLAT* - latitude of subsolar point, degrees 


None 


AEX 


Atmospheric extinction factor(or peak flux at None 

2 

solar noon, Btu/hr-ft ) 


RESTRICTIONS; 


None 


CALLING SEQUENCE ; 

CALL SURFP ( PNAME, ALAT,SUNLAT, AEX) 

NOTE; 

♦For PNAME • 3HEAR, SUNLAT is input as day of year (l.< SUNLAT ^ 365.) 
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APPENDIX E 

SEGMENT DESCRIPTIONS 


Segment Name PAGE 

NPLOT, OPLOT, PLOT E-2 

FFCAL, NFFCAL, RBCAL, E-3 

CMCAL, RTCAL E-4 

DICAL, DRCAL E-5 

SFCAL E->6 

RKCAL, RCCAL E-7 

GBCAL, AQCAL E-8 

QOCAL E-9 


I 
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SEQIENT NAME I NPLOT 

PURPOSE ; 

This segment generates pictorial plots of nodal surfaces. 


RESTRICTIONS: 


None 


CALLING SEQUENCE ; L NPLOT 


SEGMENT NAME ; OPLOT 

PURPOSE; 


This segment generates pictoral plots of the spacecraft in orbit. 


RESTRICTIONS; 


None 


CALLING SEQUENCE; L OPLOT 
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SEGMENT HAME: 


PLOT 


PURPOSE: 


This segment generates function vs time plots of absorbed and 
incident heat rates and fluxes. When used in conjunction with 
operations block FORTRAN that writes data to a plot data unit, this 
segment provides general x vs y plot capability. 

RESTRICTIONS; 


Reference Subroutine PLDATA 

CALLING SEQUENCE ; L PLOT 


SEGMENT NAME; 


FFCAL 


PURPOSE; 


This segment calculates all form factors for Che active 
configuration. 

CALLING SEQUENCE ; L FFCAL 
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SEGMEOT NAME t HFPCAL 

PURPOSE: 


This eegaent calculetes high precision fora factors using the 
Nusselt-sphere technique. 

CALLING SEQUENCE : L NFFCAL 


SEGMENT NAME : RBCAL 

PURPOSE : 


This segsient computes all "image factors" for configurations 
containing one or more specular surfaces. It computes form factors 
from all nodes to images of all nodes » as seen in the specular 
surfaces, and adds these form factors to the "direct" form factors 
computed by FFCAL or NFFCAL to create "total" form factors or image 
factors. 

RESTRICTIONS ; 

1. Requires prior computation of direct form factors using 
"FFCAL" or "NFFCAL". 

2. Specular surfaces must be flat (RECT, DISC, TRAP) with one 
node per surface. 

3. Considers first order reflections only. 

CALLING SEQUENCE : L RBCAL 
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SEGMENT NAME l CMCAL 

PURPOSE: 


Thir. MgMnt coabincf fora factor aaCricaa according to uaar-input 
corraapondanca data and auto-conbina corraapondanca data for polygona. 

CALLING SEQUENCE : L CMCAL 

RESTRICTION : Call la aaanlngful only aftar an FFCAL or NFFCAL 

axacuClon undar tha configuration nama daflnad In CMDATA. 


SEGMENT NAME ; RTCAL 

PURPOSE ; 

Tbla aagnant computaa "Image factora" (aaa Segment RSCAL) ualng a 
ray-tracing technique. (See aectlon 5.12.2: Image factora ualng Ray 

Traclng-aagmant RTCAL, and Appendix I.) Direct form factors are 
computed within this segment, so a prior execution of FFCAL or NFFCAL 
la not neceasary. 

RESTRICTIONS: 


None 


CALLING SEQUENCES : L RTCAL 


NOTE: This segment not available on CDC. 
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SEGMEKT MAME t DICAL 

PURPOSE : 

This scfMnt coapucts tulsr, planstaryi and albado irradiation 
incident on spacecraft nodes. 

RESTRICTIONS: 


Cali valid only after previous calls have been aade to define 
spacecraft geoaetryt location in space, characteristics and distances 
Oi heat source bodies, and computation accuracy paraaMters. 

CALLING SEQUENCE: L DICAL 


SEGMENT NAME : DRCAL 

PURPOSE : 

This segment computes the component of solar flux resulting from 
the image of the sun as seen in the specular-diffuse surfaces by each 
node. These components are added to the direct flux values computed 
by OIC.U. to obtain total direct flux. 

RESTRICTION: 


Call valid only after a previous call to DICAL, using the sasM 
configuration. 

CALLING SEQUENCE : L DRCAL 
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SEGMENT NAME ; SFCAL 

PURPOSE t 


a. Segment computes analytically and stores on cape tables of 
internode blockage (shadow) factors for use in direct irradiation 
calculations. 

b. When a complete shadow factor file is supplied on the RSI 
Capet segment is executed in order Co pass shadow Cables into 
program storage and initialize DICAL to compute irradiation using 
shadow Cables. 

RESTRICTIONS: 


Application controlled by user*called Subroutine DISTAB (reference 
Aopendix D p. P-20) 

CALLING SEQUENCE : L SFCAL 
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SEQIENT NAME 


RKCAL 


PURPOSE: 


This segment computes rsdiation conductor values and punches (at 
user's option) output data in thermal analyzer format* Output card 
images are printed. 

RESTRICT I ONS ; 

Call valid after spacecraft geometry is defined and matching gray 
body matrix is computed. 

CALLING SEQUENCE; L RKCAL 


SEOIENT NAME : RCCAL 

PURPOSE ; 

This segment computes radiation conductors, simplifies and 
condenses these conductors using the ERN and MESS techniques, and 
provides output in punched card and/or BCD tape form. 

RESTRICTIONS : 

Call valid after spacecraft geometry is defined and matching gray 
body matrix is computed. 

CALLING SEQUENCE; L RCCAL 
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SEGMENT NAME : GBCAL 

PURPOSE ; 

Segment computes end stores grey-body factor matrix. 
RESTRICTIONS ; 

Same as RKCAL 

CALLING SEQUENCE ; L GBCAL 


SEQUENT NAME ; AQCAL 

PURPOSE ; 

This segment computes absorbed heat rates in two wavebands, 
accounting for diffuse reflection. 

RESTRICTIONS ; 

Appropriate direct irradiation, gray-body factors, and surface 
properties must be in system storage. 

CALLING SEQUENCE ; L AQCAL 
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S2GMENT NAME ; QCXJAL 

PURPOSE ; 

This segment accesses absorbed flux data, applies correspondence 
data to combine noaes (if applicable), and generates orbital average 
and absorbea flux vs time arrays. Arrays are output in thermal 
analyzer format on cards or BCDOU tape. 

RESTRICTIONS; 


None 


CALLING SEQUENCE ; L QOCAL 
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RADIATION CONDENSER SEGMENT THEORY 


A. BASIC CONCEPTS 


Th« Multiple Encloeuxe Siaplificetioc; Shield (MESS) technique end the 
Effective Redietion Node (ERM) technique ere independent end cen be diecueeed 
•eperetely. Consider en N-node redietive enclosure thee foras e section of e 
coaplex therael aodel. The teapereture of node i is e function of thexael 
redietion coupling end the epplied heet loed, Q ^(essuae thet heet loeds 

resulting froa conduction end convection ere included in Q^). The 

steedy>stete teapereture of node i is then given by 


r N 
(L 
L 


O- 


Q,)/ 


N 

L 

j-i 


d* A, 




( 1 ) 


B. ERN TECHNIQUE 


In epplying the ERN technique, the enclosure redietion conductors for 
the ith node ere divided into priaery end N-P^ secondery couplings. The 

suanetion tera in the auaeretor of Equetion (1) cen then be written es follows: 






k»l 








(2) 


The nuaber of redietion conductors cen be reduced by errenging the conductors 
in decreesing order of the conductor vslue (A^F^j) end replecing the secondery 

coupling suaaetion of Equetion (2) with e single conductor coupled to en ERN. 
That is, 


N 

iS, 

A*? 

I 





L 


O' 


♦In Appendix F, the letter F shell denote the srey-body factor, 3 . 
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The ERN temperature is calculated by the thermal analyzer program as a 
steady*state node temperature based on a fourth-power, conductor-weighted 
average of the enclosure node temperatures using the secondary conductors. 


t N N 


N N -1 

/LX <TAF 
i»l W ‘■*J 


+l 






(^) 


Using the relationships of Equatins (2) and (3), the approximate ith node 
temperature can be written from Equation (1) as a function of the ERN 
temperature. 


L cr A.FikT ( L 


<r ^i^U^^ERN 


i+1 



y (T A.F. 


t 

4 
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C. APPLICATION OF TBi BIN TBCHNIQDE 


The eignificent radleCion fraction defined by Che relationship 


RFRAC - 



E 



( 6 ) 


la specified by the user. The nuaber of priaary conduetora, P^^ 
deterained by suaaing conductor values for a given node until Che atna is 
greater chan the fraction RFRAC of the sua of all conductors to the node. 
That is, 



'iFlk >'*'*'=* 


( 7 ) 


All primary and reverse direction conductors are flagged to be used intac^. 

Thte secondary conductors for each node are auaaed to detensine Che conductor 
value for the node~to~CRN coupling. 

Since the error in Che approxiaate teaperature is a function of Che 
enclosure teaperature band, the ERN technique results can be iaproved if nodes 
that deviate significantly from Lhe average teaperature of the encloaure are 
not coupled Co Che ERN. These analyst*de fined nodes are referred to as 
special nodes. 
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The percencige reduction in enclosure conductors end subsequent 
network error as « result of applying the EKM technique are controlled by the 
analyst's selection of an RFRAC value consistent with the known accuracy of 
problen parameters (enclosure geometry, surface optical properties p etc). 

Experience shown that the greatest percentage reduction in 
conductors results for enclosures with more then 75 nodeSp significant 
shadowing and low^'emi ttance surfaces. An RFRAC value of 0.7 has been found to 
result in a significant reduction in conductors with acceptable error for 
typical radiation enclosures. 


D. MESS TECHNIQUE 


The MESS technique provides the analyst with a means of dividing a 
radiation enclosure into an arbitrary number of subenclosures. 


MESS node pairs are defined by the analyst at the interface between 
subenclosures as two planar surfaces with the property of absorbing and 
emitting all energy incident upon them (black surfaces). Consider an N*node 
subenclosurey n, as shown in Figure where the subscripts r and r* refer 

to the HESS node pair of the nth and jth subenclosures, respectively. 


Temperatures in n are affected by T, 


MESS 


, which represents the average 


thermal effect of the j subi.*nclosure nodes on the nodes of n. The primsry 

conductors of Equation (2) include conductors to MESS nodes. For a general 

subenclosure, n, with R interface MESS nodes, the primsry radiation coupling 

n 

Ssimmation for node i 



5- a . F . T, 
L ir > 


r*l 


MESS 




( 8 ) 
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An nntrgy balnnc* on MBSS nod* r* giv«* 


Rj Py, 

' [^ Si*" ’“>C * Ji +r 

«i»r' j 


T 

k k 






+ (T A 




a(*r' 


( 9 ) 


F represents Che reflections between n end j due t-J nonblsck subcnclosure 
r T 

surfeces end is obteined froa Che radiation interchange natrix for each 
subcnclosure. 
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MODULARIZED ENCLOSURE 


f 




Figure F-1 MESS Technique One-Way Conductor-. 
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Th« cpproxiutt ttaptratur* of Ch« ich nodo io obcainod froa tquoCioa 
(5), uting Equation (8), at 

"l' ■ i [k "““‘r' " ik 

Q 

N 8 

^ ^ERH ^ ^ ^ ^ ^ 

\ V .k (10) 

T1 1 


Tht error in is a coapltx function of the percentage of Elll 

secondary conductors , tesperature band of the subenclosure nodes, and the 
nuaber os aubenclosures. In a variety of probleaa studied p the error has sen 
found to be negligible* 


£. APPLICATION OF THE MESS TECKNIQUE 

Generation of NESS one^vay conductors froa the subenclosure radiant 
interchange aatrix requires that the analyst ipecify the interface MESS node 
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p«irc. As no4« eonduccert art (taaratad, Nttt aedaa art flaggatf and 
appropriata ona-way conductors ara t*o*'*C*^ for v** Cha thanaal analysar 
prograa. 


Tha location of KE8I Mode pairs in an anclosura is influancad byt 

a. tha nuBiber of subanclosura surfacssi 

b. gaoaatric coasidaracions; 

c. aApactad tharaal gradiants; 

d. tha nuad»ar of analysts availaOla ts work on tha anclosura. 

Optiaun raduction in fora factors and conductors occurs in large anclosurss 
divided such Chat tha subanclosuras contain approxiaataly equal nuabars of 
nodes. For enclosures divided into tvo approxiaataly equal subanclosuras, up 
to 50Z reduction in tha nuabar of fora factors and conductors can be expected. 

r. EUI/MZSS AFPLXCATKm 

Tha EHI and MESS tachoiquas can be applied separately or 
siaultanaously as tha particular problea dictates. Hhay they ara applied 
siaultanaously, an EHI is defined for each subanclosura and tha MESS nodes ara 
considered to be special nodus; that is, MESS nodes ara no' coupled to tha IKM. 

C. SUMMAIY 

Tha EIX/MESS technique reduces tha nuabar of fora factors end 
rsdiation conductors necessary for anclosura radiation analysis and extends 
the analysis to include anclosures of arbitrary coaplaxity. Tha use of the 
EUl/MESS technique can result in significant savings in tiaa, both for the 
analyst and the coaputer. 
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APPENDIX G - TAPE NAME DESIGNATIONS AND SUMMARY INFORMATION 


I. TAPE /FILE INFORMATION 
II SUMMARY - USER TAPE/FILE INFORMATION 
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TAPE NAME 

AVAILABILITY** 

DESCRIPTION 

NOUT 

PP/P 

Print Output File 

DI 

PP 

Preprocessor Data Input File 

RIO 

PP/P 

Random Access Data File 

CMERG 

PP 

CMERGE Tape 

EMERG 

PP 

EMERGE Tape 

RSI 

PP/P 

Permanent Restart Input Tape 

RSI2 

P 

Auxilliary Restart Input Tape 

RSO 

PP/P 

Pennanent Restart Output Tape 

PNCH 

PP 

Punch Output File 

SCI 

PP 

Scratch File 

SC2 

PP 

Scratch File 

SC 3 

PP 

Scratch File 

CMPL 

PP 

Logic Preprocessor Output File 

SQNTl, 

PP/P 

Sequential Data File 

DIR 

PP/P 

Flux Data Block File 

FFR 

PP/P 

Form Factor Data Block File 
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GBIRR 

PP/P 

Correspondence Date Input File 

PLSR 

PP/P 

Shadow Factor Data File 

RTI 

P 

Temporary Restart Input Tape 

RTO 

P 

Temporary Restart Output Tape 

BCDOU 

P 

BCD Data Output Tape 

FILMPL 

P 

Plot Output File 

TRAJ 

PP 

Trajectory Tape 

USERl 

P 

User File 

USER2 

P 

User File 

rpR 

P 

Equivalent form factor infor- 
mation file. 

FF 

PP/P 

Forte Factor Data Storage File 

GBIR 

P 

Infrared Grey-Body Storage File 

GBSO 

P 

Solar Grey-Body Storage File 

PLS 

P 

Planetary Form Factor Save File 

TQ 

P 

Total Heat Rates Storage 

SCRl 

P 

Scratch File 
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SCR2 P 

SCR3 P 

SCRR P 

RARR P 

PUN P 

DI P 

SAVES PP 


Scratch File 

Scratch File 

Random Scratch File 

Random I/O Data File 

Punch Output File 

Direct Irradiation Data Storage 
File 

Output file to Save Source data 


♦*PP ; Pr € pr oc e s a or ; 


P: Processor 
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II. SUMMARY USER TAPE/FILE INFORMATION 

A. Input Tapes/l'iles 

1) RSI - Typical data stored are; model, FAs, GBs, RBs, SFs, DIs, and 
DRs. Source would be TRASYS II RSO tape* 

2) RTI - Temporary storage of FA, GB, RT, DI, interim calculations* 
Source would be a TRASYS II RTO tape* 

3) CMERG - Any BCD data source could be TRASYS I RTO or TRASYS II USERl 
tape* 

4) EMERG - Could consist of segment(s) of TRASYS input model* Source 
would be TRASYS II RSI/RSO tape. Also used by subroutine RSMERG. 

5) TRAJ “ Trajectory tape. Source would be an MPAD trajectory tape* 

6) RSI2 - Auxilliary restart tape. Used to merge FF data from a 
previous run into current run. 

B. Output Tapes/Files 

1) RSO “ Typical data stored are model, FAs, CMs , GBs, RBs, RTs, SFs , 
DIs, and DRs. Used as a TRASYS II RSI input tape. 

2) RTO - Used for temporary storage of FA, GB, RT, and DI interim 
calculations. Used as a TRASYS 11 RTI input tape. 

3) USERl “ Typical BCD data stored are: FFs and DIs. Can be used as 

TRASYS II CMERG input tape. See Section II~c, Appendix G. 

4) BCDOU ~ BCD data stored for thermal analyzer (SINDA) interface 
includes RADKs, cyclic and averaged heating rates* 
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C. Preprocessor Tapes/Files 

Processor Tapes/Files 


2 

RSI 

RSI 

RSO 

RSO 

CMERG^ 



EMERG EMERG 

RTI^ 

RTO 

BCDOU 

USERl 


TRAJ^ 


RSI 2 


Freed internally within TRASYS runstreara at end of preprocessor 
execution. 


Freed internally within TRASYS runstream when an end of file or parity 
error is encountered. . 
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Appendix I 

Development of Equations for Diffuse 
Plus Specular Radiation Analysis 


APPENDIX I 


DEVELOPMENT OF EQUATIONS 
FOR 


DIFFUSE PLUS SPECULAR RADIATION ANALYSIS 


I. AHALYTICAL DEVELOPMENT 


Tht attuaptioQt and groundrulaa and tha davalopnant of Cha nathanacical 
aquations for diffuaa-plus<-spacular radiation analysis ara prasantad in this 
section. 

I . Assunptions and Croundrulas 

Tha folloving asaunptions and groundrulaa wara used in tha analytical 
davalopaant present herein for diffuaa-plus-spacular radiation analysis 
techniques. 


a. All surfaces ara considered to be sani-gray (accounts for 
absorptions and reflection, but no anission in tha ultra-violet 
portion of tha spactrun; accounts for absorption and reflection as 
well as eaission in tha infrared portion of tha spcctrua). 

b. Equations ara developed for use in analysing radiation enclosures 
consisting of diffusa, specular, and/or diffusa-plus-spaeular 
surfaces using an inaging tachaiqua. 

e. All eurfacas ara considered to emit diffusely and to reflect with 
<tiffusa and specular conponants such that tha relationship 

♦ T - 1. 

1111 
is satisfied. 

d. All rurfacas with specular coaponants of reflectance ara 
restricted to planar surfaces to sinplify inaging. 

a. Only first-order inagas ara considered (that is, no inages of 
inages or inagas in inagas are generated). 
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2. Dtvlop— nt of Bqu«tion> 


Th« d«v«lopBfat of oquotions for radiation intarchangc factora follows 
tha saaa proctdura for both tha infrarad and ultra-violat portions of r.ha 
•pactriM with tha only diffarancaa boing in notation. Tharafora, only thosa 
aquations applicabla to tha infrarad portion of tha spactruw ara davalopad 
hart. 


Considar a radiation ancloaura consisting of N surfacas. Tht not haat 
flux froa any ona of thasa surfacas can ba raprasantad by 


**l,nat 


N 

j-i 


J (T 



( 1 ) 


whara is tha radiation intarchangc factor that couples surface i to sur- 

face j. 


The nathod of approach that is applied hare in the dcvclopaent of 
radiation interchange factor equations is an extension of the nethod 

sat forth by Cebhart for purely diffusa enclosures (references 2, and 3. 
The special utility in this fonsulation is that it yields coefficients which 
represent the fraction of energy cnitted by a surface that is absorbed by 
another surface after reaching the absorbing surface by all possible paths. 

Considering first-order inages only, the general equation for the 
Cebhart-type absorption factors for a diffuse-plus-specular enclosure can be 
written 



' Vn * 'ijoo * 

k«l Sfl ' 



l-l, 2 M; j-l,2,...N 


( 2 ) 
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By M«nt of a can by tatv axaaiination» aquation (2) can ba iataryracad aa 
followai 

Tba fraction of tha anargy laaving aurfaca i that ia finally abaerbad by 
aurfaca j aquala tha aiai of 

a. tha anargy that goaa diractly froa aurfaca i to aurfaca j and ia 
abaorbad, 

b. tha anargy that goaa froa aurfaca i to aurfaca j by all poaaibla 
firaC-ordar apecular raflactiona and ia abaorbad, 

c. that fraction of tha anargy that goaa diractly froa aurfaca i to 
each of tha aurfacaa in tha ancloaura, finally arrivaa at surface 
j by all possible pacha due Co diffusa raflactiona, and ia 
absorbed. 

d. that fraction of the anargy that goes froa surface i to each of 
tha surfaces in the enclosure by all poaaibla first'-'ordar specular 
reflections, thence Co surface j by all possible paths due to 
diffusa raflactions, and is abaorbad. 
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RafiirNittlng nhc c** rma la equaclon <’2) yialda 
N N 


Aj‘ " s/i 


1,2..... N , i - 1,2, 


( 3 ) 


Eduation (3) can bo further almpltfied by dafinlnf an "laaga factor" 

(0^^) 4u cnac fraction oi cha energy chat leavaa aurfaca i and at 

furfaca J both directly and by all poaaibla firat-order apacular raflactiona, 
auch chat 

’ ^ij A ^ij(k)’ 


» - 1.2 N ; J - 1.2, 


.N 


(4) 


Substltutloa of equation (4) into aquation (3) ylalda 

^IJ A ^in /^nj 

Raarrangaawnt of cha cerma in equation (5) yialda 


(5) 


^ ^i« ‘ A ^iai^ /^«J * ^ij 


<*) 


Equation (6) can ba reprasanted in matrix form as 


[°ij] [/^ij]" t^j^ijl 


(7) 


whara D la an N X N coafflclant matrix with gancral alamant 

®ij ■ / Aj 


°ij ' 


(8> 


Tht a^stastf of aquations reprasanted by ( 7 ) can ba soLvad by matrix 
inversion to obtain the absorption factors ( ^ 

N 

iS * ^ D ^ r 0 

r ii Im ^ j mj 


(9) 
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The radiatioB intarchaat* factors 




ara ralatad to Cha absorption factors 


rafaranca 1) by tha axprassioa 


J 


ij 


*l 


( 10 ) 


and, uslnt tha usual argusMnts for tha consarvation of anargy, tha raciprocity 

ralation fc<r tha values of <?, is 

tj 




^^31 


( 11 ) 


Tha foragoing aquations apply to radiation anclosurss consisting of any 
coaibination of diffusa and specular surfaces ranging froa totally diffusa to 
totally specular anelosuras. 

'ilhan tha problaa consists of an "incoaplata** enclosura and s space node 
is present, tha radiant interchange factor to space is coaputad froa? 


A 



is 


• A, 




(I?) 


for an fl-noda ineoaplata enclosure. 
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!!• Image Factors Using Ray Tracing 

The use of some type of ray treeing technique seems to be the only 
feasible approach to account for tBultiple specular reflections in the 
calculation of radiation interchange factors. It has the added attraction of 
not restricting the specular surfaces to flat plates. 

The RTCAL link in TRASYS generates image factors exactly analagous to 
those described in I* above. They are stored on the FF file and used by the 
GBCAL link in the same manner as the image factors generated by RBCAL. The 
following is a description of the RTCAL approach. 

If node i and/or node j are specular» rays are constructed and traced 
to determine specular components of the pertinent image factors. As an 
example of this procedure, let node i be diffuse and node j be specular (that 
is, node j has a specular component of reflectivity). The elemental form 
factor from element 1 on node i to element 1 on node j is calculated using the 
unit sphere technique. Then, a ray (vector) is constructed from element 1 on 
node i to element 1 on node j with a ray strength equal to the elemental form 
factor between these elements. The ray is then imaged in a surface normal at 
element 1 of node j and its ray strength reduced by the specular reflectivity 
of node j. This reflected ray is then examined to determine which liode, if 
any, it then impinges upon. Assuming that it strikes node k, the image factor 
from node i to node k ( *.^) i, increased by the amount of the current ray 
strength. If node k is specular, the ray is imaged in a surface normal at the 
point of impingement and the ray strength is reduced by the specular 
reflectivity of node k. This process is continued until the ray fails to 
impinge upon another model surface, until the ray strikes a purely diffuse 
surface, or until the ray strength is reduced to some user-input percentage of 
its initial value. 

The foregoing procedure is repeated from each element on node i to each 
element on node j and for each node pair in the model. The resultant image 
ctor matrix is written on the FF file to be subsequently read by the GBCAL 
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link for Che calculation of radiation incerchange factors. Mote that the 
GBCAL input data on the FF file is exactly the same in content and structure 
as if Che combination of FFCAL (or NFFCAL) and RBCAL had been executed prior 
to GBCAL. The difference is that the imaprr factors include Che effects of 
multiple specular reflections and the specular surfaces are not restricted to 
flat places. 
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Appendix J 

Use of Adiabatic Closure 
Surfaces 


APPENDIX J 

USE OF ADIABATIC CLOSURE SURFACES 
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A thermal analyst is sometimes confronted with the requirement to 
determine temperatures and heat flows in an enclosure that would require a 
great number of nodes to furnish adequate simulation, but also shows a great 
derl of symmetry and duplication of geometry. 

An example of such an enclosure is shown below. 



Subenclosures A, B and C each contain an identical heat source/sink 
node (X), aiid each subenclosure can **see" into the adjacent suherclosure with 
a significant view. If the thermal boundary conditions for each of the 
subenclosures are approximately the same, a condition of thermal radiation 
symmetry exists, that is, energy leaving B across plane abc is equivalent to 
the energy entering B across plane abc. The same can be said about the 
situation at plane def. Thus, planes abc and def are adiabatic surfaces in 
the sense that the net heat flow across them is zero. It is, therefore, 
correct thermal simulation to create a TRASYS model of subenclosure B with 
adiabatic ’’mirrors*' at planes abc and def to simulate the presence of 
subenc losure^ A and C. Notice that this takes into account only the effects 
of subenclosures A and C. If a longer string of identical subenclosures exist 
and it is desired to account for them, two or more enclosures can be 
constructed and closed with adiabatic mirrors. A two enclosure model would 
thus account for the thermal affects of two enclosures on each end, a three 
enclosure model would account for three on each end, and so on. 
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Implementation of this procedure is quite simple using subroutine 
ADSURF, There is no need to define the shape or location of the two 
reflecting planes, although the true enclosure area of the reflecting planes 
is a required input. When the user needs one or more adiabatic reflector 
planes, he merely adds an extra BCS to his surface data and defines within it 
a single rudimentary surface with very high reflectivity. This surface 
definition might be as follows: 

CCl CC7 

BCS ADSURl 

S SURFN « 10000, TYPE * RECT, PROP « .0001, .0001, ACTIVE * TOP 

PI = 1.0, 1.0, 0.0 

NOTE: BCS ADSURl can contain one and only one surface. 

With the adiabatic surface defined thus, the area must be determined 
outside TRASYS and entered as an argument to subroutine ADSURF. If desired 
the adiabatic surface may be defined in the usual manner and its area will be 
determined by the program. A rero would then be used as the area argument in 
ADSURF. 


With this surface in the surface data block, the user may apply the 
adiabatic "mirror** technique to an enclosure by a call to subroutine ADSURF 
subsequent to his form factor execution. If desired, the effect of the 
adiabatic surface can be determined in a single run by executing FFCAL or 
NFFCAL, GBCAL and RKCAL in the usual manner, followed by a call to ADSURF, 
followed by GBCAL and RKCAL execution to produce another set of radiation 
conductors, this time with the **mirrors*' in place. 
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Absorbed heat data, 3-127 » 5-24 

output segment, 5-24 
segment, 5-24 
subroutines, 4-5 3f£ 

heating multiplying factors, 4-53, D-5 
solar heating, 4-53 
Accuracy of form factors, B-4 

shadow representation, B-6 
parameter, form factor (FFACC), B-4 
Accuracy parameters, DICAL, 4-35, D-13, D-15 
Active configuration, 3-135 
node , 3-54 
side concept, 3-30 
imaging, 3-80 
information, 3-55 
surface, 3-29ff 
ADD subroutine, 4-6, D-2 
Adiabatic "closure** surfaces, 4-13, J-lff 
ADSURF subroutine, 4-13, D-3 
Albedo, 2-5 

reflections, 4-53 
solar heating, 4-53 
Alphanumeric input, 3-2 
Angular measurements, 3-56 

Approximate radiant interchange factors, 4-46 
AQCAL pseudo-file format, C-7 
segment description, E-8 
AQDATA subroutine, 4-53, D-5 
AQPRNT option, 4-53 
Area modification, 4-56 
Argument, subroutine call, 2-3 
Arithmetic expression data values, 3-25 
expressions, 2-3 
operations, 2-3 
Array data accessing, 3-26 

block, 3-2, 3-24, 3-27, 3-127 
formats, 3-25, 3-66 
values, 3-25 

node, 3-98, 3-111, 3-113 
Attitude, inertial, 3-127, 4-25ff 
vehicle, 4-33 

orientation options, 4-33 

Automatic correspondence, BCS dup, 3-79, 3-1193 3-121, 3-122 

, BCS image, 3-83, 3-119, 3-121, 3-122 
, polygons, 3-119 

generation of correspondence data, 3-121 

equivalent form factors, 3-86ff 
node number incrementing, 3-67 
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AuComatic node plots, 3-8 

error contingency, 3-8 
subdivision, 3-8 
Automatically scaled plots, 3-8 
B card, 3-59, 3-60 
Background information, 2-1 
BCDOU tape/ file, G-5 

BCS (block coordinate system), 3-31, 3-53, 3-91, 4-6 
card, increment node number, 3-80ff 
data, 3-91ff 

block, 3-91 
input detail, 3-92 

dup, automatic correspondence, 3-79, 3-119, 3-121ff 
DUP card format, 3-2 

option, 3-78ff, 3-84, 3-119 
duplicating, 3-76ff 
identifier card (B card), 3-59, 3-60 
image, automatic correspondence, 3-83, 3-119, 3-121ff 
IMAGE option, 3-82ff, 3-85, 3-119 
variable names, 3-92 

Block coordinate system (BCS), 3-31, 3-53, 3-91, 4-6 

card, increment node number, 

3-82ff 

data, 3-91ff 

block, 3-91 
input detail, 3-92 
dup, automatic correspondence, 
3-79, 3-119, 3-121ff 
DUP card format, 3-79 

option, 3-78, 3-84, 3-119 
duplicating, 3-78ff 
identifier card (B card), 3-59, 

3-60 

image, automatic correspondence, 
3-83, 3-119, 3-121ff 
IMAGE option, 3-82ff, 3-85, 3-119 
variable names, 3-92 

Blockage, 3-57 

factor, 5-7 

Boundaries, Box Surf. Data Def., 3-52 
Box definition, 3-56 
Branching statements, 3-125 
BUILD card, 3-135 

continuation, 3-136 
option, 3-135 
subroutine, 4-5, D-7 
BUILD/ADD cards, 3-127 
BUILDC subroutine, 4-5, D-7 

Bypass, direct incident shadow logic, 4-34, D-13, D-I5 
form-factor shadow logic, 4-11, D-24 
Calculations, irradiation, 3-36 
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Calculations, radiation conductor, 3-*36 
Capabilities, program, 1-1, 1-2 
Card column designations, 2-3 

merge unit, 2-2, 3-14, 3-16 
Cards, comment, 3-59 

control, 1-3, 3-59 
inactive, 3-10, 3-16 
Cartesian coordinate systems, 3-31 
CCS (central coordinate system), 3-31, 3-52, 4-6 
Celestial coordinate system, 4-24, 4-25 
Central coordinate system (CCS), 3-31, 3-52, 4-6 
Change geometry with respect to time, 4-6, D-9 
model name, 3-135, 4-5, D-7 
punch/tape output formats, H-l££ 

CHGBLK subroutine, 4-6, D-9 

Clock/cone angles, locate spin axis, 4-42 

shadow factor tables, C-13 
sun and planet, 4-39 
CMCAL pseudo-file format, C-9 
segment description, £-4 
flow, 5-28 

CMDATA subroutine, 4-11, D-10 
CMERG, 2-2 

edit options, 3-18 32 

tape, 3-14, 3-82, ) 

unit, 3-14, 3-16 
Combining form factor, 3-118 
, node, 3-117ff 

Comment cards, 2-4, 3-59, 3-64 
data format, 3-69 
COMMENT data, 2-4, 3-64 
Comments, FORTRAN comment card, 3-64 

surface data COM data, 3-35, 3-69 
Common blocks, program, A-2ff 
Component surface heat data values, 4-48 
Condenser, radiation, 4-‘>4 

, ERN/MESS, 4-44ff, E-7, F-lff 
Cone, surface definition of, 3-44 
Configuration, ..ctivc, 3-135 
factor, 3-57 
name, 2-4, 3-125 

Conservation check, energy, 4-51 

gray body, 4-51 

Constant definition card (K earn), 3-59, 3-61 
Constants definition, 3-61 
, solar, 4-68 

Stefan-Boltzmcn, 4-44, 4-50 
stored planetary data, 4-29 
user, 3-24, 3-61 
Continuation, BUILD card, 3-136 
cards, 3-60, 3-61 
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Continuation flag, 2-3 
Control cards, 1-3 

constant, 3-24 

field (punched-card) , 2-1, 3-59 
cards, 3-59 
fonsats, 3-59 

Conventions, terms and data, 2-2 
Coordinate system definition, 3-31 

process, 3-73 
hierarchy, 3-32 
, surface (SCS), 3-40 
systems, Cartesian, 3-31 

location process, 3-73 

orientation, 3-3lff, 4-18, 4-23, 4-24ff, 

4-32, 4-39, C-13 

Core size, 1-2, 3-9 
Correspondence data, 3-117ff 

, automatic generation of, 3-121 
block, 3-2, 3-124 

example, 3-121 
structure, 3-120 
formats, 3-120 
generation, 3-121ff 
pseudo-file format, C-3 
variable definitions, 3-119 
Cylinder surface definition, 3-43 
D card, 3-59, 3-61, 3-63 

Data block, quantities ,3-2, 3-24, 3-61, 3-127 
blocks, 3-2, 3-23 

, basic structure, 3-3 
card convention, 3-25 
conventions, 2-2 
, dimensional, 3-52 
field, 2-1, 2-4 
form factor, 3-102 
formats, equivalence, 3-101 
plotter, 5-2 
, position, 3-52 
properties, 3-52 
value, 2-3 

values, arithmetic expression of, 3-25 
fixed-point, 3-25 
Hollerith, 3-25 
integer, 3-25 
DATAI unit, 3-14 

Data modification routines, 4-34ff 
DAWN/DUSK, 4-70 
DAWN variable, 4-70, D-17 
Default, 3-32, 3-;>9, 3-71, 3-95 
values, 3-24, 3-35ff 
Definitions, 2-5ff 
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Deleting, 3-16 

D1 (direct irradiation), 2-5, 5-20, 5-28 
, computation of, 3-30 
definition, 2-5 
flags, 4-34 
segment, 5-2011 
shadow-only surfaces, 3-36 
subroutines, 4-2 3ff 
DIACC, DIACCS, 4-35 

DICAL accuracy parameters, 4-35, D-13, D-15 
pseudo-file format, C-4 
segment flow, b-22 

description, E-5 
DICOMP subroutine, 4-41, D-J. 1 
OIDll subroutine, 3-il2, 4-34ff, D-13 
DlDTiS subroutine, 3-113, 4-3<4if, D-13 
D1DT2 subroutine, 4-37ff, D-15 
D1DT2S subroutines, 4-3 7tt, D-ib 
DIDT3 subroutine, ^-70, D- i 7 
D1DT3S subroutine, 4-0^, D-17 
Diffuse ml rated emissivity, 4-58 

plus specular radiation analysis equations, 1-ltf 
properties tiata, 3-71 
property assumption, 3-52, 3-5b, 3-57 
input options, 3-37 
solar absorptivity, 4-58 
Dimension inf onaai ion, 3-52 
Dimensional data, 3-52 
•’r.its, 3-5b 

Dimensions, linear, 3-50 

data tonnat, J-7l 
DIKEAD subroutine, 4-67, D-i‘7 
Direct incident ^31) Hux, 2-5 

i ecompu r at i on, 3-113, 3-1 i 6 
shadow logic by-pass, 4-34, D-13, D-15 
irtUi. ion (Di), 2-5, 5-20, 5-2 b 
, computation of, 3-30 
de t i n 1 1 1 on , 2-5 
1 1 dg s , 4-34 
segment, :^-2 0ff 
stiaaow-only surfac,s, 3-36 
i>ub r\>ut 1 ne s , 4-2 31 1 
rad iat u-u, '—20 
Solar heating, 

Disk, suit ace iielinitiou oi , 3-a2 

DlSl’Ah sub lout me. D-iVlt 

DIT'iP subroutine, 4-M2tt, D"2U 

Uii'ii'S subroutine, #-o211, U“2U 

DNAMir., 2-j 

Du loop, j- 1 2 7 

Doc uuie at . 1 1 1 on da^a, 3 

b 1 ucK s , i-2 , 3-2 i 
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Documentation data blocks format, 3-23 

cards, 3-23 
prirtout , 3-24 

DRCAL ile format, C-b 

st^jment, 3-27 

description, E-3 
flow, 5-32 

DRDATA subroutine, 4-46, D-23 
Driver logic, user's, 3-3 
Duplicating, BCS, 3-78ft 

surfaces, 3-73 

DUP and IMAGE options, 3-7Iff 
option, 3-"73tf 
DUSK, DAWN, 4-70 
DUSK variable, 4-70, D-17 
Eccentricity, orbit, 4-28 
EDIT/OONTROI data block, 3-1, 3-7tf 
Edit data block, 3-l4ff, 3-16, 3-20 

directives, 3-16, 3-18 
input, 3-18 
options, 3-18, 3-19 
input, 3-17 

tape, 2-2 
labels, 3-16 
line numbers, 3-18 
numbers, 3-ib, 3-127 
operations, 3-17, 3-21, 3-22 
segment logic flow, 3-13 

Effective radiation node (ERN) radiation condenser technique, 

4-44, F-lff 

Elemental gria variations, B-2ff 
EMERG, 3-14 

t*pc, 3-lb 
unit, 3-16 

End of data card, 3-130 
Energy conservation check, 4-31 
source direction, C-13 

Equal-incrc. ^ic surface breakdown nodes, 3-39ff, 3-33 
Equations, diffuse ^ specular radiation analysis, I-ltt 
Equivalence nata formats, 3-101 
Equivalent form factors, 3-86ff, 3-101 
ERN (effective radiation node) fechnique, F-2ff 
radiation condenser teennique, 4-30, F-lff 
ERN/MESS application, F-9, 3-12ff 

radiation condenser, 4-30ff, E-7, F-lff 
technique, 3-lLff 
ERPLQT, 3-8 

Error cont ingerxy , automatic node plots, 3-8 
node plots, 3-8 
, tape parity, 3^146 
message, 3-39 
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Exponents, 2-3 
FF, see fora factor 

FFACC (form factor accuracy parameter), B-4 
FFCAL pseudo-file format, C-6 
segment description, £-3 
flow, 5-8 

FFDATA subroutine, 3-93, 4-7ff, D-24 
FFNDP subroutine, 3-103, 3-112, D-26 
FFREAD subroutine, 4-67, D-27 
FFZERO variable, D-25 
File and tape conventions, 2-1 
designations , 3-lOf f 
Fixed point, 3-23 

data values, 3-23 
Floating-point data value, 3-61 
numbers, 2-3 

Flow charts, 1-4, 3-22, 5-4ff 
Flax data, 3-lllff, 3-127, 4-66 
block, 3-lllff 

example, 3-114 
node array, 3-112 
formats, 3-113 
variable definitions, 3-113 
, direct incident, 2-5 

routines, specular properties input, 5-26 
values, 3-113 

Format, control field, 3-59 

, single variable input, 3-65 
surface data, 3-59 

Form factor (FF), 2-5, 3-30, 4-34, 4-67 

accuracy parameter (FFACC), B-4 
calculation accuracy, B-lff 
calculations, 3-57 
combining, 3-118 

segment, 5-24 

computation seouence hierarchy, 3-95 
data, 3-93ff, 3-102 

block, 3-2, 3-93ff, 3-101 
example, 3-101 
node array, 3-98 
formats, 3-98 
definition, 2-5 
designators, 3-97 
, equivalent, 3-86, 3-101 
matrices, 5-9 
, minimum value, 4-8 
node array, 3-98, 3-103 
, precision, 5-9 
recomputation, 3-95, 3-100 
request matrix, 3-95 
segment, 5-7ff 
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Fora factor shadow logic by-pass, 4-11, D-24 
method, 5-9, B-5ff 
shadowing concept, B-3££ 
flags, 4-11 

shadow-only surfaces, 3-89 
solution routine, 5-7, 5-9, B-2££ 

, Nusselt unit sphere with shadowing, 5-9, E-3, B-8£f 

without shadowing, 3-102 
techniques, double suiomation, 5-7, B-2£f 
, unit sphere, with shadowing, 5-9, B-8££ 
without shadowing, 3-102 

specular properties input routines, 5-25f£, I-2£f 
subroutines, 4-7 to space, B-*!0 
variable definitions, 3-107, 

X area matrix, 3-95 
FORTRAN, 1-4. 1-5, 3-3, 3-125, 4-4 
coding form, 3-13 
comment card comments, 3-64 
compiler, 2-4 

GB (gray body) conservation check, 4-51 
definition, 2-5 
factor data, 4-48 

definition, 2-5 
segment, 5-11 
X area matrix, 4-46 
GBAPRX subroutine, 4-46, D-28 
GBCAL pseudo-file format, C-9 
segment description, E-8 
GBDATA subroutine, 4-46, D-30 
General subroutines, 4-5 

Generation of equivalent form factors, 3-86ff 
Geometric shapes, 3-29 

surface boundaries, 4-55 
Geometry, problem, 3-12:.», 5-1 

with respect to time, change, 4-6, D-9 
Gravitational constants, 4-29 
Gray body (GB) conservation check, 4-51 
definition, 2-5 
factor data, 4-48 

definition, 2-5 
X area matrix, 4-46 
surfaces, 3-56 
h format, 2-4, 2-5 
Header cards, 3-5 

record format, C-2 
Heat, AQPRNT option, 4-53 

component surface data values, 4-53 
incident, 4-53 
rate, definition, 2-6 
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Heat rate /heat t lux *>jtput data plotting',, D“3 / 

, rotlected, 4^33 

SINDA arrays and subioutirie calls, H'297tt, H~451it 
total, 4“33 

Heating rate output multiplying tactors, 4“34, D- 37 
Hierarchy, coordinate systeia, 3-32 

tonu-tactor computation sequence, 3-93 
Hollerith, 2-3 

data values, 3-23 
int oiTiiat ion, 2-4 
strings, 2-3, 3-69 
1 card, 3-:) 9, 3-o0 

ICS (intermediate coordinate system), 3-31, 3-32, 3-60, 3-61 
data format, 3-6o 
definition, 3-31 

card (I card), 3-3 9ff 
, ret ere nee, 3-32ff, 3-66, 3-73 
IFFSHO variable, 4-il, 0-24 
Image tactor, 3-38, 1-3 
segments, 3-23 

using ray-t racing, 3-28, 1-7 
plane, 3‘73ff, 3-8U 
IMiVet option, 3-73tf 
Imaged suit aces, 3-73ff, 3-80 
Inactive cards, 3 -10, 3-16 
Incident flux source, 3-30 
heat, 4-33 

Increment node number, BOS card, 3-82ff 

N card, 3-39, 3-b2 
radiation conductors, 4-49, 4-30 
Identification, nodal surface, 3-33 
numb e r s , node, 3-32 

Identifier, 2-4 
Individual data values, 3-27 
Lnevtiai attitude, 3-128, 4-30ft 
IntonnatLon, dimension, 3-32 

nodal breakdown, 3-32 
shadowing, 3-32 

Intrareii ( IR ) reflections, 4-33, 3-24 
shadowing, 3-32 
specular i e t lec t ivi t y , 4-bO 
transmissivity, 4-38 
Input data, 3-1 

samples, 3-13, 3-20, 3-b3, 3-77, 3-81, 3-84ff, 3-116 
3-124, 3-138, 3-132, 4-43, 3-16, 3-17, H-2 
H-114, H-220, H-306, H-366, H-436 

, surface, 3-33 
deck, 3-itt, 3-14, 3-16 
s t rue ture , 3-3M 
, punched-card , 2-1 
tapes/ t 1 ies , G-3 
Inserting, 3-lo 
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Integer count, 3-27 

data values, 3-23 
Integers, 2-3 

Interchange lactor, radiation, definition, 2-6 

subroutines, 4-44ff, D-28£f, 

D-6I, D-64 

Interface, thennal analyzer, 1-1, 5-11 

Intermediate coordinate system (ICS), 3-31, 3-52, 3-60, 3-61 

data format, 3-66 
definition, 3-31 

card (I card), 
3-59ff 

, reference, 3-32ff, 3-66, 3-73 
IR (infrared) reflections, 4-53, 3-24 
shadowing, 3-52 
specular reflectivity, 4-60 
Irradiation calculations, 3-36 
Isothennal nodes, 3-30 
ITRC71 option, D-14 

TTRC72 option, D-25 
K card, 3-59, 3-61 
L cards, 3-123, 3-127, 3-150 
Library list of processor segments, 4-3 
subroutines, 4-1 

, processor and preprocessor, 1-2 
Limits, node number, 3-34 
Line number, edit, 3-18 
Linear dimension units, 3-56, 3-61 

card (D card), 3-59, 3-61, 3-63 
dimensions, 3-56, 3-62 
Link, 2-2 (also see Segment) 
calls, 3-123 
List data, 3-19 
LIST subroutine, 3-112, D-30 
Look angles, locate sun and planet, 4-34 
shadow factor tables, C-13 
Master node array, 3-93, 3-98, 3-103 
Materials, semitransparent, 3-57 
Matrix, form factor x area, 3-95 
gray body x area, 4-46 
Measurements, angular, 3-56 
Merging. 3-lb 
HESS technique, F-5ff 
Minimu?! value tonn factor, 4-8 
MODAR subroutine, 4-55, D-34 
Model, 2-5 

0 locks, 3-4 
name, 2-5, 3-136 

change, 3-135, 4-5, D-7 
MODPR subrout' ne, A-57, D-36 
MODPRS subroutine, 4-l>i^ D-38 
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MODSHD subroutine, 4-0 0, D-37 
MODTK subroutine, 4-56, D-39 
Moon, 4-29 

Multiple Enclosure Simplification Shield (MESS) technique, F-5ff 
Multiplying factors, absorbed heating, 4-53, D-5 

heating rate output, 4-54, D-57 
radiation conductor, 4-48ff, E-7 

N card, 3-59, 3-62ff 
NDATA subroutine, 4-13ff, D-41 
NDATAS subroutine, 4-13ff, D-'41 
New surface card (S card), 3-59, 3-60, 3-62 
NFDATA subroutine, 3-93, 4-9ff, D-43 
NFFCAL pseudo-file format, C-6 
segment description, E-3 
flow, 5-10 

NFFSET variable, 3-147, 4-12 
Nodal preliminary shadowing checks, B-ff 
surface, definition, 2-6 

identification, 3-53, 3-55 
numbering, 3-55 
surfaces, 3-30, 3-32, 3-53 
NODDAT subroutine, 4-61, D-45 
Node, 2-6 

, active, 3-53 
array, 3-96, 3-ill, 3-113 

, flux data block, 3-112 
form factor, 3-98, 3-103 

data block, 3-98 
, master, 3-93, 3-98, 3-103 
punch output, 3-103 
punching, 3-103 

, shadow factor data block, 3-107 
boundaries, unequal, 3-71 
boundary dimensions, 3-70ff 
combining, 3-117ff 
definition, 2-6 
generation order, 3-55 

identification number increment card (N card), 3-59, 3-62£f 
numbers, 3-52 

imaging, 3-81 

input data plotting, 4-15, D-41 
number array, 3-33, 3-67 
limits, 3-33 
range, 3-35 
redefinition, 3-62 
sequencing, 3-35, 3-55 
numbers, 3-62 

plots, error contingency, 3-8 
options, 4-1 5ff, D-41 
sbadower only, 4-16 
plotter, 3-1 
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Node property modification) 4-58 
renumbering) 3**62 
NodeS) isothermal) 3-3u 
number of) 2-6 

surface breakdown) equal-increment) 3-40ffi 3-55 
unequal-increment) 3-34) 3-71 

NOGO option, 3-7) 3-9 
Nonshadowing surfaces, 3:-29 
NPLOT segment description, E-2 

Nusselt unit sphere form-factor solution, with shadowing, 5-9, E-3 

without shadowing, 3-102 

ODATA subroutine, 4-1 9ff, D-46 
ODATAS subroutine, 4-1 9ff, D-46 
ODPROG subroutine, 2-4, 3-125, 3-127 
ONLY option, 3-97, 3-99 
Operations block formats, 3-136, 3-138ff 
examples, 3-137ff 

data block, 3-3, 3-8, 3-24, 3-27, 3-125ff 
restart files, 3-147 

operations, 3-144 

OPI4OT segment description, E-2 
Optical properties, 2-6, 3-52 

definition, 2-6 

Options data block, 3-1, 3-7ff, 3-8, 3-13, 3-125ff 

example, 3-8 
variables , 3-7 
input detail, 3-9ff 
ORBGEN option, 3-127 
Orbit coordinate system, 4-32 

definition in celestial coordinate system, 4-24, 4-32 
eccentricity, 4-28 

/orientation input aata plotting, 4-19ff, D-46 
plot coordinate system reicrence, 4-23 
plotter, 5-1 

ORBITi subroutine, 4-23, D-48 
ORBIT2 subroutine, 4-30, D-50 
ORIENT subroutine, 4-30ff, D-52 

Orientation, coordinate systems, 3-3lff, 4-18, 4-23, 4-24ff, 

4-32, 4-39, C-13 

on planet surface, 4-70 
, vehicle, 4-33 

vehicle attitude options, 4-33 
Output, printout, H-297ff, H-451ff 
punched cards, 4-53ff, D-64 
segment, absorbed heat data, 5-24 
tapes/files, G-5 

Parabolic surface definition, 3-46 
Periapsis, 4-23ff 

Permanent restart input (RSI) tape, 3-147, 4-61 




12 


Revision 3 


Permanent restart output (RSOj tape, 3-147 
PFFSHl) subroutine, 4-15, D-53 
Pictorial plot segments, 5-i 

binary plot unit tormat, 5-2 
data plotter, 5-2 
node plotter, 5-1 
orbit plotter, 5-1 
Planet constant data, 4-29 
orientation, 4-301' f 
rotation rate , 4-68 
shadow, 5-1 
surface option, 4-70 

subroutines , 4-6 8ff 

Planetary infrared (IR), definition, 2-6 
PLDATA subroutine, 4-20, D-54 
Plot package subroutines, 4-i5ff 
parameters, 4-15 
segment flow, 5-4 
unit format, 5-2ff 
PLOT segment description, E-2 

Plotting, heat rate/heat flux output data, D-54 
node input data, 4-16, D-41 
orbit/orientation input data, 4-19ff, D-46 
Point data format, 3-71 

defined surface, 3-53 

method ot surface definition, 3-33, 3-40 
Polygon subdivision, 3-56 
Polygons, automatic correspondence, 3-119 
Position card, 3-37, 3-69 
data, 3-52, 3-69 
format, 3-69 

Precision form factor segment, 5-9 
Preprocessor, 1-2, 3-14 


and processor libraiy, 1-2 
tapes/files, G-6 

Printout output, H-297ff, H-45iff 
Problem geometry, 3-125, 3-1 
size, 1-2 

Problems, sample, H-lff 
Processor and preprocessor library, 1-2 
1 ibrary , 4-1 

segments, 5-lff, (see segment name) 
, library list of, 4-3 
Program capabilities, 1-lff 
common blocks, A-2ff 
data storage scheme, 3-126 
features, TRASYS , 1-1 
variable redefinition, 3-123 
Properties data, 3-32, 3-36 
format, 3-71 
, optical, 2-6, 3-52 
Property array pseudo-file format, C-3 
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Pseudo flies, RSI/RSO, C“2fl 
Punch output node array, 3~i03 
Punched card input, 2-1 
cards, 2-1 

output, 4-54ff, D-64 
Punching a node array, 3-103 
Punch/tape output format change, H-lff 
QOCAL segment description, E-9 
flow, 5-26 

QODATA subroutine, 4-54, D-57 
(^INIT subroutine, 4-55, D-59 
Quantities and array data blocks, 3-24ff 

, data, accessing, 3-26 
rules for input, 3-24 
data block, 3-2, 3-24, 3-61, 3-127 
Quantity data accessing, 3-26 
constants, 3-61 
formats, 3-25 
R cards, 3-59, 3-149 
Radiant interchange factor, 5-25 

definition, 2-6 

Radiation condenser, 4-49 

segment, 5-12 

theory, F-iff 

technique, ERN, 4-44, F-lff 
conductor (RC>, 2-6, 4-48, 5-llff 
definition, 2-6 

multiplying factors, 4-48ff, E-7 
sample problem using ERN/MESS, 5-12 
segment, 5-ilff, E-7 
IRK) segment, 5-11, E-7 
conductors, increment, 4-49, 4-49 
interchange factor definition, 2-6 

subroutines, 4-46ff, D-28ff, D-61 D-64 
segment , 5-1 1 
subroutines, 4-46 
model simplification, 4-49 
RADK, definition, 2-6 
RAY TRACING (RT) , 

segment, 5-2 7ff 

RB (real body) segment, 5-25, E-3 
RBCAL pseudo-file format, C-10 
segment flow, 5-29 

description, E-3 
RBDATA subroutine, 4-15, D-60 
RC (radiation conductor), 2-6, 4-48, 5-lIff 
definition, 2-6 

multiplying factors, 4-48ff, E-7 
sample problem using ERN/MESS, 5-12 
segment, 5-11, E-7 
RCCAL sample input, 5-1 7ff 

segment description, E-7 
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RCCAL segment flow, 5-14 
RCDATA suDroutine, 4-49ff, D-61 
Real Dody (RiJ; segment, 5-25, E-3 
RECOMP option, 3-94, 3-100 
Recomputation, direct incident, 3-112, 3-115 
tonn factors, 3-95, 3-100 
shadow factor table, 3-110 
Redefinition of program variables, 3-125 
Reference form, 2-4 

plane for imaging surfaces & BCSs (R card), 3-59, 3-150 
Reflected heat, 4-53 

solar heating, 4-53 
Reflections, albeao, 4-53 

IR, 4-53, 5-24 
solar, 4-53, 5-24 
Reflectivity, 3-57 
Renumbering nodes, 3-62 

surfaces, 3-62 
Reserved Word List, A-lff 
Restart control subroutine, 4-62ff 
files, 3-147 
input (nSl; tape, 3-144 
operations , 3- 144f f 
output IRSO) tape, 2-2, 3-147 
Lupe format, C-lff 
tape merging, 4-62ff, D-66 
RK (radiation conductor) segment, 5-11, E-7 
RKCAL segment flow, 5-13 

description, E-7 
RKHATA subroutine, 4-48, D-54 
Rotation variables, 4-55 
Rotations, 3-66, 4-39, D-72 
Routines, user-supplied, 3-125 
KSI/RSO pseudo files, C-2ff 
RSI tape, 3-14, 3-16, 3-111, 4-60 
RSO file 3 127 

tape, 2-2, 3-14 

format, C-2ff 
write se<^uence, 3-145 
RSMEKG subroutine, 4-6 2ff, D-63 
RSTOFF subroutine, 3-112, 3-145, 4-62, D-67 
RSTON subroutine, 3-111, 3-145, 4-62, D-68 
RTCAL segment, 5-30ff 
KTDATA subroutine, 4-15, D-69 
RTl tape, 3-148 

RTl/RTO tape/file assignment, contents, C-2ff 

formats, C-2ff 
option data block, 3-iO 

RIO tape, 3-148 

write sequence, 3-145 
Run time, 1-2 
S card, 3-57, 3-58, 3-60 

Sample input data, 3-13, 3-20, 3-63, 3-77, 3-81, 3-84ff, 3-115, 

3-124, 3-138, 3-152, (coat on next page) 
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Sample input data (cone I), 4-45, 5-16, 5-17, H-2, H-114, 

H-II4, H-220, H-306, H-366, H-456 

problems, H-Iff 

SCS (surface coordinate system) , 3-31, 3-40, 4-55 
definition, 3-31 

surface data input method, 3-40ff 
Segment definition, 2-2 

descriptions, £-lf f 
execution calls, 3-125 
Semitransparent materials, 3-57 
SF (shadow factor), 3-57, 5-23 

application/control (subroutine 
DISTAB) 4-41ff, D-19ff 
data, 3-105ff 
block node array, 3-107 
definition, 2-7 
formats, 3-107 
operations detail, 3-110 
segment, 5-23 

table recomputation, 3-110 
tables, 3-108 

variable definitions, 3-107 
SFCAL pseudo-file format, C-Il 
segment description, E-6 
SHADE option, 3-36 
SHADIN variable, 4-36, D-48, D-50 
SHADOUT variable, 4-31, D-48, D-50 
Shadow data block, 3-2 

formats, 3-107 

entry/exit point definition, 4-36 
Shadow factor (SF), 3-57, 5-23 

data. 3-105ff 
block node array, 3-107 
definition, 2-7 
formats, 3-107 
operations detail, 3-110 
segment, 5-23 

application/control (subroutine 
DISTAB) 4-41ff, D-19ff 
table recomputation, 3-110 
tables, 3-108 

variable definitions, 3-107 
method, form factor, 5-9, B-5ff 
only surfaces, 3-89 
Shadower only node plots, 4-16 
surfaces, 3-89 
solutions, 3-52 

surfaces, 1-2, 3-29, 3-30, 3-57 
Shadowing accuracy parameters, 4-34, 4-38 
concept, form factor, B-5ff 
flags, form factor, 4-9 
, form factor, concept, B-5ff 
flags, 4-9 
information, 3-52 
solutions, 3-56 
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Shadowing surfaces, 1-2, 3-29, 3-30, 3-57 
form factor, 3-90 
Shapes, geometric, 3-29 
SHF AC pseudo- file format, C-8 

SINDA (Systems Improved Numerical Differencing Analyzer), 1-1, 

2-6, 3-127, 5-24 

arrays and subroutine calls, heat, H-297ff, H-451ff 
Single variable input format, 3-65 
Size, problem, 1-2 
Solar "constant," 4-67 

heating, absorbed, 4-53 
albedo, 4-53 
direct, 4-53 
reflected, 4-53 
reflections, 4-53, 5-24 
specular reflectivity, 4-59 
transmissivity, 4-57 

Solution routine, form factor, 5-7, 5-9, B-2ff 
Source edit data block, 3-1 
editing, 3-14 
editor, 3-14 
listing, 3-16 

Space node computation method, 4-49 

identification, 4-43, 4-50 
Spacecraft orientation, 4-39, 5-1 
spin definition, 4-43 
Specular diffuse surfaces, 5-25 

plus diffuse radiation analysis equations, I-lff 
properties input, 3-37, 3-56 
data, 3-71 
reflectivity, 3-58 
routines, flux, 5-27 

form factors, 5-25ff, I-2ff 
surfaces, 5-27 

Sphere surface spheroid surface definition definition, 3-45 
Spin axis definition, 4-43 
rate, 4-41 

restrictions, 4-38, D-16 
SPIN subroutine, 4-39, D-70 
SPINAV subroutine, 4-40, D-67 

Star locations in celestial coordinate system, 4-25 
Stefan-Boltzman constant, 4-49, 4-50 
STEP cards, 3-127 

number, 3-125, 3-127 
cards, 3-135 

numbers, definition, .3-125, 3-127 
example, 3-139ff 
program-defined, 3-127 
STFAQ subroutine, 4-54, D-72 
Stored planet property values, 4-29 

planetary data constants, 4-29 
Subdividing a polygon, 3-56 
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Subroutine block format s, 3-*I46ff 
calls» 3-26 

data blocki 3-3» 3-L43f£ 
descriptions^ 4-4 » D-lf£ 

Subroutines, absorbed heat, 4-33 

data modilication, 4-56 
direct irradiation, 4-23 
form factor, 4-7 
general, 4-3 
library list of, 4-Iff 
planet surface, 4-68 
plot package, 4-15 
radiation interchange, 4-46 
restart control, 4-61 
user callable, 4-lff 
Sun and star locations, 4-25 
vector, 4-68 
Surface, 2-7 

, active, j-30 

breakdo%m, equal-increment nodes, 3-40ff, 3-55 
unequal-increment nodes, 3-35, 3-71 
coordinate system (SCS), 3-31, 3-40, 4-55 

definition, 3-31 

surface data input method, 3-40 ff 

data, 3-29ff, 3-31, 3-65 

block, 3-2, 3-32, 3-52, 3-56, 3-61, 3-63, 3-72 
COM data comments, 3-36, 3-69 
comment data format, 3-69 
constants, 3-61 
control field formats, 3-59 
coordinate system definition, 3-31 
hierarchy 3-32 

systems location process, 3-73 
deck structure, 3-60, 3-61 
dimensions data format, 3-71 
format, 3-59 

identification format, 3-67 
input, 3-8, 3-33ff, 3-61, 3-65 
data 3-33ff 
method, SCS, 3-40 f£ 
philosophy, 3-33 
manipulation, 3-60 
nede boundary dimensions, 3-70 
point data format, 3-68 
properties data format, 3-68 
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Surface data single variable input format, 3-63 
surface identification format, 3-67 
variables, 3-33ff, 3-52, 3-65 
descriptions, 3-60, 3-62, 3-69 
definition, 3-32ff 

box, 3-47 
polygon, 3-52 
ogive, 3-50 
rectangle , 3-40 
spheroid*, 3-48 
toroid, 3-49 
trapezoid , 3-41 
structural element , 3-31 
structural tape , 3-51 
cone, 3-43 
cylinder, 3-42 
disk, 3-41 
parabolic , 3-45 
sphere, 3-44 
DUP option, 3-74, 3-77 
geometry definition, 3-40ff 
identification format, 3-67 
IMAGE option, 3-75, 3-81 
number, 3-33, 3-33 
reflectance, 3-56 
renumbering, 3-62 
types, 3-52 

Surfaces, nodal, 3-30, 3-32 
nonshadowing, 3-29 
shadov 2 r-only , 3-89 
shadowing, 3-29 
specular, j-57 

SURFP subroutine, 4-68, D-74 

System structure, 1-2 

Systems Improved Differencing Analyzer (SINDA) program, l-l, 

2-6, 3-127, 5-25 
arrays and subroutine 
calls, heat, H-297ff, 
H-4 31f f 


Tape and file conventions, 2-1 
/file information, G-lft 
name designations, G-lff 
parity error contingency, 3-146 
Temporary restart input (RT1> tape, 3-148 
output (RIO) tape , 3-148 
Terms and data conventions, 2-2 
Thermal analyzer interface, l-l, 5-12 
irradiation segment, 5-20ff 
problem expression, l-l 
radiation, 5-20 
Thin intervening bodies, 3-57 
Total heat, 4-453Trailer record format, C-3 
Translation variables, 3-52 
Transmissivity , 3-57 
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TRASYS omMON cards. 3-130 
conponcncs. 1-2 
configuration nai&e, 2-3 
definition, 1-1 
description, 1-1 
TRASYS features, 1-1 
flew, 1-3, 1-4 
functions, 1-1, 1-4 
BK>del, 2-5, 3-1 
program features, 1-1 
system structure, 1-2 
TRAJECTORY tape options, 3-130ff 
True anosMly definition, 4-31 
TRUEAH variable, 4-31, D-46, D-48 
Typographical conventions, 2-1 

Unequal-increment surface breakdown nodes, 3-33, 3-71 
node boundaries, 3-71 

Unit sphere form factor solution, with shadowing, S-9ff, K-lff 

without shadowing, 3-102 

Univac 1110, 1-2 
User callable subroutines, 4-lff 
called routines, 4-lff 
constants, 3-24, 3-61 
supplied routines, 3-125 
tape/file information, G-3ff 
User's driver logic, 3-3 
USERl tape, 3-112 

assignment, 3-11 
format, 3-94, 3-112 
use, 3-94, 3-112 
Variable, 2-4 

AQPRNT, 4-48 
DAWN, 4-65, D-i7 

definitions, 3-97, 3-107, 3-113, 3-119 
, DUSK, 4-65, D-17 
FFZERO, D- 24 
IFFSHO, 4-10, D-23 
input, 3-65 
names, 3-25, 3-65 
redefinition, 3-125 

NFFSET, form factor restart file control, 3-147, 4-12 
SFPRNT, shadow factor print control, 5-24 
, SHADIN, 4-31, D-46, D-48 
SHADOUT, 4-31, D-46, D-48 
TRUEAN, 4-31, D-46, D-48 
Variables, allowable range of, 3-35ff 

options data block, 3-7, 3-9 
rotation, 3-52 
surface data, 3-33ff, 3-40 
translation, 3-52 

VeS (vehicle coordinate system), 4-28 
Vehicle attitude orientation options, 4-28 
coordinate system (VCS), 4-28 
orientation, 4-28 
Waveband, 3-57 
Yank, 3-16 

ZERO option, 3-97, 3-100 
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